Прокси `api.telegram.org`

В ряде регионов прямой доступ к api.telegram.org ограничен. MaxBotStat предоставляет прокси-домен, который ведёт себя как зеркало api.telegram.org, но физически живёт на нашей инфраструктуре:

api-tg.capybara.maxbotstat.ru   →   api.telegram.org
api-max.capybara.maxbotstat.ru  →   platform-api.max.ru

Использовать прокси — необязательно. Он включается автоматически для исходящих запросов с нашей стороны (рассылки, отправка одиночных сообщений, аватарки) и доступен дополнительно для использования в вашем собственном коде.

Как использовать в собственном коде

Замените базовый URL Telegram Bot API:

// Было
const TG = 'https://api.telegram.org'

// Стало
const TG = 'https://api-tg.capybara.maxbotstat.ru'

Все эндпоинты Telegram Bot API остаются прежними:

bash

curl "https://api-tg.capybara.maxbotstat.ru/bot<TOKEN>/getMe"
curl -X POST "https://api-tg.capybara.maxbotstat.ru/bot<TOKEN>/sendMessage" \
     -d "chat_id=123" -d "text=Hello"

Аналогично для Max — замените https://platform-api.max.ru на https://api-max.capybara.maxbotstat.ru.

Доступ

Прокси-домены принимают подключения только из доверенных подсетей. Если вы хотите использовать прокси из своего сервера, напишите в поддержку с вашим IP — добавим в allowlist.

Безопасность

Сертификат — Let's Encrypt с авто-обновлением, TLS 1.2 / 1.3.
Прокси не сохраняет тела запросов и токены в долгосрочное хранилище — это прозрачный proxy с подменой Host header.
Если бот живёт за пределами региона, где api.telegram.org блокируется, прокси не нужен — обращайтесь напрямую.

Когда использовать

Сценарий	Решение
Сервер бота в регионе с блокировкой Telegram	Использовать прокси MaxBotStat
Бот за пределами таких регионов	Прокси не обязателен
Только webhook (никаких исходящих запросов)	Прокси вообще не нужен

Лимиты

Размер тела запроса — до 50 MB (как у Telegram).
Прокси не повторяет запросы при таймауте: ваш клиент должен ретраить сам.

Прокси api.telegram.org ​

Как использовать в собственном коде ​

Доступ ​

Безопасность ​

Когда использовать ​