Швидкий старт

Що потрібно

• 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..."} і нічого не списують.

Що читати далі

1. Авторизація — як передавати токен.
2. Рейтліміти — квоти запитів і одночасності.
3. Тарифікація — вартість методів.
4. Помилки — формат помилок.