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, массив кнопок и check_button_text. Повторный запрос для того же user_id создает новую выдачу; старые выдачи проверяются только через /api/v1/check. Тексты можно локализовать в настройках источника через JSON вида {"ru":"...","en":"..."}.

POST /api/v1/check

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

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

POST /api/v1/orders

Targeting fields: filter_language_code, require_premium, filter_age_group, filter_gender, filter_country, filter_device_os.

Создает покупку трафика. Типы: channel, chat, bot, site, ad_display. Для казино/ставок передавайте is_gambling=true; такие кампании показываются только источникам с allow_gambling=true.

POST /api/v1/short-links

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