BotoHub API

Документация по интеграции

ОП (/get-tasks)
Задания (/get-tasks)
ОП расширенный (/get-tasks-extended)

Продвинутая интеграция

POST https://botohub.me/get-tasks

Возвращает список ссылок. Вы сами формируете и отправляете сообщение.

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 Нет спонсоров для показа
Время привязки: 5 мин.

Спонсоры закрепляются за пользователем. При повторном запросе возвращаются только невыполненные.

Режим заданий (продвинутый)

POST https://botohub.me/get-tasks

Возвращает одну ссылку за раз. Вы сами формируете и отправляете сообщение.

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.

Расширенная интеграция

POST https://botohub.me/get-tasks-extended

То же, что /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 ему больше не выдаются
Время привязки: 5 мин.

Спонсоры закрепляются за пользователем. Пока привязка действует, повторные запросы возвращают тот же список с актуальными completed по каждому спонсору; max_op и excluded_ids на закреплённый список не влияют.

Когда все спонсоры выполнены, ответ содержит completed: true и весь список с completed: true у каждого — до конца привязки.
Отличия от /get-tasks:

/get-tasks — массив ссылок, выполненные исчезают из массива
/get-tasks-extended — массив объектов, выполненные остаются с completed: true
Бот заблокирован или невалидный запрос — оба возвращают {"tasks": []}
Фейковые аккаунты (fake: true): если антифрод BotoHub помечает пользователя фейком, в ответе появляется "fake": true. Спонсоры BotoHub при этом снимаются и пропадают из tasks, внешние спонсоры остаются со своими статусами. Признак появляется со следующего запроса после пометки; когда его нет — считайте false.

Пример aiogram

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