Справочник API

Все эндпоинты живут под https://api.telesint.dev/v1/ и ожидают заголовок Api-Key. Начать — со страницы быстрого старта.

Аккаунт

GET /v1/me/Информация об аккаунте, баланс и роли. Бесплатно.

POST /v1/me/reset-tokenРотация API-токена. Бесплатно.

Пользователи

GET /v1/users/{identifier}Полный профиль пользователя по ID или username. 1₽ или 4₽ в зависимости от данных о группах.

GET /v1/users/{identifier}/similarПользователи с общими группами. 6₽.

GET /v1/search/Полнотекстовый или точный поиск пользователей по имени. 1₽.

Группы

GET /v1/groups/{identifier}Информация о группе по ID или @username. 2₽.

GET /v1/groups/{identifier}/similarГруппы с общими участниками. 1₽.

GET /v1/groups/{identifier}/membersПостраничная выгрузка участников. 1₽–15₽, затем час бесплатно.

Формат ответа

Эндпоинты, возвращающие данные о пользователях и группах, оборачивают полезную нагрузку в { "data": ... }. Эндпоинты аккаунта (/v1/me/, /v1/me/reset-token) возвращают данные на верхнем уровне.

Документированные ошибки API описаны на странице Ошибки.

Успешные платные ответы сообщают списание и актуальный баланс в заголовках Telesint-Billing-Charged и Telesint-Billing-Balance.