Документация
Подключение бота к шлюзу занимает одну строку.
Как это работает
Вы меняете базовый URL Bot API на адрес шлюза со своим ключом в пути. Всё остальное — как раньше.
Telegram: https://api.telegram.org/bot<TOKEN>/<method>
Через нас: https://tg-relay.scriptora.ru/k/<KEY>/bot<TOKEN>/<method>
iПодходит любая библиотека, где можно задать базовый URL. Библиотеки на MTProto — Telethon и Pyrogram — работают в обход HTTP Bot API, поэтому через шлюз не идут: там просто нечего менять.
Подключение
Выберите библиотеку — ниже появится пример с уже подставленным ключом. Подсвечена строка, которую нужно изменить.
Управление ключами
—Ключ создаётся в кабинете и показывается один раз — мы храним только его хеш.
—Можно держать несколько ключей на проект и ротировать без простоя: создать новый, обновить конфиг, отозвать старый.
—Новый ключ начинает работать в течение 30 секунд (кэш ключей на узле). Отзыв — так же.
Коды ошибок шлюза
Ошибки приходят в формате Telegram, чтобы фреймворк разобрал их штатно.
| Код | Причина | Что делать |
|---|---|---|
| 401 | Ключ не найден или отозван | Проверьте, что скопировали ключ целиком, или создайте новый |
| 402 | Исчерпан лимит тарифа | Посмотрите потребление и повысьте тариф |
| 429 | Превышена частота запросов | Снизьте частоту или повысьте тариф; смотрите Retry-After |
| 502 | Upstream недоступен | Проблема сетевой связности до Bot API; смотрите страницу статуса |
| 504 | Upstream не ответил вовремя | Повторите запрос; при массовом характере — страница статуса |
429 от самого Telegram проходит насквозь со своим retry_after и нашим не подменяется.
Полное руководство и боевое развёртывание — в README на GitHub.