Информация об аккаунте

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	Описание.

Ошибки

Общие форматы — см. Ошибки.