Інформація про акаунт

GET/v1/me/Безкоштовно

Повертає інформацію про акаунт, який володіє поточним Api-Key: ID акаунта, баланс, множник поповнення, призначені ролі й поріг сповіщення.

Авторизація

Потрібен заголовок Api-Key.

Запит

Без параметрів і тіла.

Приклади

curl -H "Api-Key: $API_KEY" https://api.telesint.dev/v1/me/

import os, requests

response = requests.get(
    "https://api.telesint.dev/v1/me/",
    headers={"Api-Key": os.environ["API_KEY"]},
    timeout=10,
)
response.raise_for_status()
me = response.json()
print("Баланс:", me["balance"])

const res = await fetch('https://api.telesint.dev/v1/me/', {
  headers: { 'Api-Key': process.env.API_KEY },
});
const me = await res.json();
console.log('Баланс:', me.balance);

Відповідь — `200 OK`

{
  "id_": 436307416,
  "balance": 109992,
  "multiplier": 1,
  "roles": [
    {
      "name": "user",
      "description": null,
      "scopes": [
        { "name": "read_users", "description": null },
        { "name": "read_groups", "description": null },
        { "name": "search", "description": null }
      ]
    }
  ],
  "notification_threshold": 20
}

Поля

Поле	Тип	Опис
`id_`	integer	ID акаунта.
`balance`	integer	Доступний залишок у рублях.
`multiplier`	number	Множник поповнення балансу.
`roles`	масив role	Призначені ролі. За замовчуванням порожньо.
`notification_threshold`	integer \| null	Поріг сповіщення про низький баланс. Налаштовується в боті.

Role

Поле	Тип	Опис
`name`	string \| null	Ідентифікатор ролі.
`description`	string \| null	Опис.
`scopes`	масив scope	Можливості, які дає роль.

Scope

Поле	Тип	Опис
`name`	string \| null	Ідентифікатор scope.
`description`	string \| null	Опис.

Помилки

Загальні формати — див. Помилки.