LinkyGo

HTTP-API для подключения обязательной подписки в ваш Telegram-бот. Получите ключ в боте @LinkyGo_bot и вызывайте методы ниже.

Авторизация

Ключ передаётся в заголовке запроса, а не в теле:

HEADERS
X-Api-Key: ВАШ_КЛЮЧ
Content-Type: application/json

Все параметры метода — в JSON-теле запроса. Базовый адрес: https://api.linkygo.cc

curl -X POST https://api.linkygo.cc/v1/tasks \
  -H "X-Api-Key: ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{ "user_id": 123456789, "max_tasks": 5 }'

POST /v1/tasks — получить задания

Возвращает ресурсы (каналы/боты), на которые пользователю нужно подписаться.

Поле тела	Тип	Описание
`user_id` *	int	ID пользователя Telegram
`max_tasks`	int	Сколько заданий вернуть (1–10), по умолчанию 5
`language_code`	string	Язык пользователя (`ru`, `en`…)
`first_name`	string	Имя пользователя (необязательно)
`premium`	bool	Есть ли Telegram Premium (необязательно)

Ответ:

{
  "ok": true,
  "code": 200,
  "subscription_required": true,
  "count": 2,
  "tasks": [
    { "id": 185206, "type": "channel", "title": "Новости", "url": "https://t.me/example" },
    { "id": 190114, "type": "bot",     "title": "Сервис",  "url": "https://t.me/some_bot" }
  ]
}

Если subscription_required = false — подписываться не на что, доступ открыт.

POST /v1/check — проверить подписки

Проверяет, подписан ли пользователь на ресурсы.

{ "user_id": 123456789, "links": ["https://t.me/example"] }

{ "ok": true, "subscriptions": [ { "id": 185206, "url": "https://t.me/example", "subscribed": true } ] }

POST /v1/balance — баланс

{ "ok": true, "balance": 124.50, "earned_total": 980.00, "bot": { "id": 777, "username": "your_bot" } }

POST /v1/stats — статистика

Заработок по дням и по типам. Наглядная веб-версия: https://api.linkygo.cc/stat?key=ВАШ_КЛЮЧ

Вебхуки — события выполнения

Задайте webhook_url в боте. Когда пользователь выполнит или отменит задание, мы отправим на него POST:

HEADERS  X-Api-Key: ВАШ_КЛЮЧ
BODY
{
  "event": "task.completed",      // или "task.reverted" (отмена)
  "id": "evt_8f3a...",            // уникальный ID события
  "user_id": 123456789,
  "task_id": 185206,
  "url": "https://t.me/example"
}

Отвечайте 200 OK. Событие task.completed — действие засчитано (начисление на баланс); task.reverted — отписка (откат).

Формат ошибок и коды

{ "ok": false, "code": 401, "error": "invalid_api_key", "message": "Неверный или отсутствующий X-Api-Key" }

Код	error	Когда
200	—	Успех
401	`invalid_api_key`	Неверный/нет ключа в X-Api-Key
422	`missing_user_id`	Не передан user_id
429	`rate_limited`	Слишком частые запросы по пользователю