справка по подключению

документация_

Подключить бота

Пошагово для владельца бота и разработчика: тест без кода, текст задачи, примеры aiogram / Node / PHP.

открыть инструкциюсоздать аккаунт

С чего начать

важно: два разных секрета

Токен бота (@BotFather) — в URL, как у Telegram.

API-ключ — заголовок X-API-Key, раздел «API-ключи».

Полный пошаговый сценарий: quickstart за 5 минут.

API-ключи

Название ключа видно только вам. Сам ключ показывается один раз при создании. Отозванный ключ сразу перестаёт работать.

Боты

регистрация бота необязательна

sendMessage работает и без добавления бота в панель. Добавляйте бота, если хотите видеть его в аккаунте и учитывать лимит тарифа. Токен хранится только как хэш.

Шлюз

POST https://api.rogatka-push.ru/bot<TOKEN>/sendMessage + X-API-Key

подключение за 4 шага
  1. Создайте API-ключ в панели.
  2. Замените домен api.telegram.org на api.rogatka-push.ru.
  3. Отправьте тестовое сообщение.
  4. Проверьте журнал запросов: успешный ответ имеет статус 200.

Тест

В панели можно проверить getMe и sendMessage через шлюз без правки кода.

создать аккаунт для теста

Журнал

200 = Telegram принял запрос · 4xx = ошибка Bot API · 502/429 = ошибка шлюза или лимит. Подробно: ошибки 401/429/502.

REST API (внешние интеграции)

без браузера

База: https://rogatka-push.ru/api/v1

Авторизация: заголовок X-API-Key. Используйте тот же ключ, что и для шлюза.

openapi.json · полная документация в репозитории docs/API.md

Лимиты и тарифы

Лимиты зависят от тарифа. В панели можно запросить переход — администратор одобрит вручную, квоты применятся сразу после одобрения.

смотреть тарифы