API docs

Интеграция состоит из двух запросов: получить спонсоров и проверить выполнение. Токен выдается для каждого подключенного бота-продавца.

Auth

Для partner API передавайте токен в заголовке Auth. Для кабинета пользователя используйте User-Secret, который показывается в разделе документации внутри бота.

POST /api/v1/sponsors

{
  "user_id": 123456789,
  "source": "bot",
  "source_ref": "onboarding",
  "language_code": "ru",
  "is_premium": true
}

Ответ содержит request_id и массив кнопок. Если cooldown еще не истек, вернется status=wait и время ожидания.

POST /api/v1/check

{
  "request_id": "req_xxx",
  "user_id": 123456789
}

Каналы и чаты проверяются сервисным ботом. Боты проверяются токеном рекламодателя. Сайты засчитываются только после успешной проверки остальных типов в этой же сессии.

POST /api/v1/orders

Targeting fields: filter_language_code and require_premium.

Создает покупку трафика. Типы: channel, chat, bot, site. Цена должна попадать в диапазон, заданный администратором.

POST /api/v1/short-links

Создает Telegram deep-link в сервисного бота: https://t.me/<BOT_USERNAME>?start=<random_code>. Код генерируется автоматически; продавец задает только заголовок, лимит спонсоров и текст после успешного выполнения.