Тарифікація

Правило

Оплачуються тільки успішні відповіді (HTTP 2xx). Неуспішні запити (4xx, 5xx) не списуються. При нестачі балансу API повертає 400 з {"detail": "Not enough balance..."} і нічого не знімає. У цьому випадку billing-заголовки містять нульове списання й актуальний баланс.

Вартість за методами

Ендпоінт	Вартість
GET /v1/me/	Безкоштовно
POST /v1/me/reset-token	Безкоштовно
GET /v1/search/	1₽
GET /v1/groups/{identifier}	2₽
GET /v1/users/{identifier}	1₽, якщо groups і cl_groups порожні; інакше 4₽
GET /v1/users/{identifier}/similar	6₽
GET /v1/groups/{identifier}/similar	1₽
GET /v1/groups/{identifier}/members	1₽ / 5₽ / 15₽1

Усі ціни в рублях.

¹ Вартість доступу до вивантаження залежить від його обсягу: 1–10 учасників — 1₽, 11–49 — 5₽, 50 і більше — 15₽. Докладний розрахунок і правила повторних запитів описані в документації ендпоінта.

Заголовки білінгу

Кожна успішна відповідь платного ендпоінта містить:

Заголовок	Значення
Telesint-Billing-Charged	Скільки рублів списано за цей запит.
Telesint-Billing-Balance	Актуальний баланс після виконання запиту.
Cache-Control	private, no-store, оскільки відповідь містить персональні дані білінгу.

Білінг не додається до JSON: модель ресурсу залишається незмінною.

Перевірка балансу

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

{
  "id_": 436307416,
  "balance": 109992,
  "multiplier": 1,
  "roles": [],
  "notification_threshold": 20
}

• balance — поточний залишок у рублях.
• multiplier — множник поповнення балансу.
• notification_threshold — поріг, при якому прийде сповіщення про низький баланс. Налаштовується в боті.

Приклади розрахунку

Сценарій	Арифметика	Разом
Отримати за ID профілі 100 користувачів із даними про групи	100 × 4₽	400₽
Знайти й отримати 50 повних профілів із даними про групи	50 × 1₽ + 50 × 4₽	250₽
Обійти 20 груп і схожі для кожної	20 × 2₽ + 20 × 1₽	60₽
Опитувати /v1/me/ щохвилини тиждень	10 080 × 0₽	0₽

Контроль витрат

1. Виставте notification_threshold у боті — дізнаєтесь про низький баланс заздалегідь.
2. Періодично опитуйте /v1/me/ і слідкуйте за balance — цей виклик безкоштовний.