Developer docs
DarkBoost API
Черновик публичной документации для разработчиков. Финальные endpoint-адреса будут включены после запуска backend API.
Авторизация
Каждый подключенный бот получает API-ключ в разделе «Продать трафик → В ботах». Передавайте ключ в заголовке Auth.
Auth: db_your_api_key Content-Type: application/json
Получение спонсоров
POST
/api/v1/sponsors| Поле | Тип | Описание |
|---|---|---|
| user_id | integer | Telegram ID пользователя |
| chat_id | integer | ID чата запроса |
| language_code | string | Язык Telegram |
| is_premium | boolean | Telegram Premium |
curl -X POST https://darkboosts.com/api/v1/sponsors \
-H "Auth: db_your_api_key" \
-H "Content-Type: application/json" \
-d '{"user_id":123456789,"chat_id":123456789,"language_code":"ru","is_premium":false}'
Проверка подписок
POST
/api/v1/checkМетод проверяет выполнение ранее выданного блока спонсоров и возвращает актуальный статус.
{"status":"ok","completed":true,"reward":0.50}
Задания
POST
/api/v1/tasksРежим для выдачи одного задания за раз. После успешной проверки можно сразу запрашивать следующее задание.
Ошибки
| Код | Описание |
|---|---|
| 401 | API ключ не передан или неверный |
| 429 | Превышен лимит запросов |
| 500 | Внутренняя ошибка сервиса |