Документация по интеграции
Возвращает список ссылок. Вы сами формируете и отправляете сообщение.
Headers
Content-Type: application/json
Auth: {ваш_токен}
Request
{
"chat_id": 123456789,
"gender": "male",
"age": 25
}
| Параметр | Тип | Описание |
|---|---|---|
| chat_id | number обязательный | Telegram ID пользователя |
| gender | string опционально | male или female |
| age | number | string опционально | Возраст или категория c1-c6 |
Response
{
"tasks": ["https://telegram.me/channel1", "https://telegram.me/channel2"],
"completed": false,
"skip": false
}
| Поле | Тип | Описание |
|---|---|---|
| tasks | string[] | Массив ссылок на спонсоров |
| completed | boolean | Все спонсоры выполнены |
| skip | boolean | Нет спонсоров для показа |
Возвращает одну ссылку за раз. Вы сами формируете и отправляете сообщение.
Headers
Content-Type: application/json
Auth: {ваш_токен}
Request
{
"chat_id": 123456789,
"is_task": true,
"skip": false,
"gender": "male",
"age": 25
}
| Параметр | Тип | Описание |
|---|---|---|
| chat_id | number обязательный | Telegram ID пользователя |
| is_task | boolean обязательный | Должен быть true |
| skip | boolean опционально | Пропустить текущее задание |
| gender | string опционально | male или female |
| age | number | string опционально | Возраст или категория c1-c6 |
Response
{
"tasks": ["https://telegram.me/channel1"],
"prev_success": false,
"prev_outdated": true,
"completed": false,
"skip": false
}
| Поле | Тип | Описание |
|---|---|---|
| tasks | string[] | Массив с одной ссылкой (или пустой) |
| prev_success | boolean | Предыдущая задача выполнена |
| prev_outdated | boolean | Первый запрос или кэш сброшен |
| completed | boolean | Все задания выполнены |
| skip | boolean | Нет заданий для показа |
| fake | boolean опционально | Присутствует и равно true, если аккаунт помечен фейком — задания BotoHub ему больше не выдаются |
prev_success=false, prev_outdated=true — первый запросprev_success=true, prev_outdated=false — предыдущая выполнена, выдана новаяprev_success=false, prev_outdated=false — не выполнена, та же ссылка
fake: true): если антифрод BotoHub помечает пользователя фейком, в ответе появляется "fake": true, а задания BotoHub перестают выдаваться (внешние спонсоры остаются). Признак появляется со следующего запроса после пометки; когда его нет — считайте false.
То же, что /get-tasks, но каждый спонсор — объект со ссылкой, ID ресурса и статусом выполнения.
Выполненные спонсоры не пропадают из списка, а помечаются completed: true — можно показывать
пользователю статус по каждому спонсору. Дополнительно можно задать число спонсоров и исключить ресурсы.
Headers
Content-Type: application/json
Auth: {ваш_токен}
Request
{
"chat_id": 123456789,
"max_op": 3,
"only_has_check": true,
"excluded_ids": ["-1001234567890"],
"gender": "male",
"age": 25
}
| Параметр | Тип | Описание |
|---|---|---|
| chat_id | number обязательный | Telegram ID пользователя |
| max_op | number опционально | Сколько спонсоров выдать. По умолчанию — настройка «Макс. спонсоров» бота в @botohub |
| only_has_check | boolean опционально | Выдавать только спонсоров с проверкой подписки. По умолчанию true; если передан max_op — false |
| excluded_ids | string[] опционально | Список resource_id, которые не выдавать (например, каналы, на которые пользователь уже подписан в вашем боте). Применяется только при подборе новых спонсоров BotoHub |
| gender | string опционально | male или female |
| age | number | string опционально | Возраст или категория c1-c6 |
is_task и skip игнорируются. Для заданий используйте /get-tasks с is_task: true.
Response
{
"tasks": [
{
"url": "https://telegram.me/channel1",
"resource_id": "-1001234567890",
"completed": true
},
{
"url": "https://telegram.me/some_bot?start=ref",
"resource_id": "7000000000",
"completed": false
}
],
"completed": false,
"skip": false
}
| Поле | Тип | Описание |
|---|---|---|
| tasks | object[] | Все спонсоры, закреплённые за пользователем, включая выполненные |
| tasks[].url | string | Ссылка на спонсора |
| tasks[].resource_id | string | ID ресурса в Telegram: ID канала (-100...) или числовой ID бота. Для ссылок без проверки может быть пустой строкой. Используйте в excluded_ids |
| tasks[].completed | boolean | Этот спонсор выполнен |
| completed | boolean | Все спонсоры выполнены |
| skip | boolean | Нет спонсоров для показа |
| fake | boolean опционально | Присутствует и равно true, если аккаунт помечен фейком — спонсоры BotoHub ему больше не выдаются |
completed по каждому спонсору; max_op и excluded_ids на закреплённый список не влияют.completed: true и весь список с completed: true
у каждого — до конца привязки.
/get-tasks — массив ссылок, выполненные исчезают из массива/get-tasks-extended — массив объектов, выполненные остаются с completed: true{"tasks": []}
fake: true): если антифрод BotoHub помечает пользователя фейком, в ответе появляется "fake": true. Спонсоры BotoHub при этом снимаются и пропадают из tasks, внешние спонсоры остаются со своими статусами. Признак появляется со следующего запроса после пометки; когда его нет — считайте false.
import aiohttp
from aiogram import Router, F
from aiogram.types import Message, CallbackQuery, InlineKeyboardMarkup, InlineKeyboardButton
router = Router()
BOTOHUB_TOKEN = "ваш_токен"
async def get_sponsors(chat_id: int) -> dict:
async with aiohttp.ClientSession() as session:
async with session.post("https://botohub.me/get-tasks-extended", headers={"Auth": BOTOHUB_TOKEN}, json={"chat_id": chat_id, "max_op": 3}) as r:
return await r.json()
def build_keyboard(tasks: list) -> InlineKeyboardMarkup:
rows = [[InlineKeyboardButton(text="✅ Спонсор" if t["completed"] else "Спонсор 🙏", url=t["url"])] for t in tasks]
rows.append([InlineKeyboardButton(text="✅ Проверить", callback_data="bh_check")])
return InlineKeyboardMarkup(inline_keyboard=rows)
@router.message(F.text == "/start")
async def cmd_start(message: Message):
result = await get_sponsors(message.chat.id)
if result.get("completed") or result.get("skip"):
await message.answer("Главное меню")
else:
await message.answer("Чтобы продолжить, подпишись 👇", reply_markup=build_keyboard(result["tasks"]))
@router.callback_query(F.data == "bh_check")
async def on_check(cb: CallbackQuery):
result = await get_sponsors(cb.message.chat.id)
if result.get("completed") or result.get("skip"):
await cb.answer("Готово!")
await cb.message.answer("Главное меню")
else:
await cb.message.edit_reply_markup(reply_markup=build_keyboard(result["tasks"]))
await cb.answer("Подпишитесь на всех спонсоров", show_alert=True)
| Код | Ответ | Описание |
|---|---|---|
| 401 | {"error": "Unauthorized"} |
Неверный или отсутствующий токен |
| 400 | {"error": "Missing chat_id"} |
Не передан chat_id |