Быстрый старт

Что нужно

API-токен (доступен в личном кабинете бота).
Любой HTTP-клиент: curl, Python, Node.js, Postman.

Базовый URL

https://api.telesint.dev

Все эндпоинты живут под /v1/.

Первый запрос

Используйте бесплатный эндпоинт /v1/me/, чтобы проверить токен и увидеть баланс:

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

Успешный ответ:

{
  "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
}

Если пришёл 401 — проверьте токен. При нехватке баланса платные методы вернут 400 с {"detail": "Not enough balance..."} и ничего не спишут.

Что читать дальше

Авторизация — как передавать токен.
Рейтлимиты — квоты запросов и одновременности.
Тарификация — стоимость методов.
Ошибки — формат ошибок.