Telegraft

Справочник по Bot API

Ограничения и их цифры

Справочник по тем лимитам Telegram Bot API, которые меняют состав возможного: потолки отправки, ограничения на размер файлов, пределы в 64 байта и 64 символа, проверка подписи, которую требует Mini App, и окна, внутри которых сообщение можно отредактировать, удалить или вернуть деньги. На каждой странице точная цифра и работающий пример.

Лимиты и механика Telegram Bot API: что входит в этот раздел

Страниц справочника
50 запланировано, у каждой точная цифра и запускаемый код
Рамки
Только лимиты и механика Bot API — это не туториал
Мягкие лимиты
Помечены как приблизительные там, где Telegram не публикует точного числа
Проверяемость
Каждая цифра сверяется по собственной документации Telegram

As of 2025-10-01, Telegram Bot API 13.4

Как читать этот справочник

У большинства вопросов про Bot API есть точный ответ, и почти ни одна страница из поисковой выдачи его не даёт. Официальная документация — это полный справочник по методам, и она сознательно не объясняет последствий; туториалы пересказывают счастливый путь. И там, и там нет главного: цифры и того, что она делает с архитектурой. Что рассылка на сорок тысяч человек занимает двадцать две минуты, что инлайн-кнопка несёт шестьдесят четыре байта и ни символом больше, что сообщение удаляется в течение сорока восьми часов, а потом уже никогда.

Эти страницы закрывают ровно этот пробел и больше ничего. Каждая берёт один лимит или один механизм, называет его в первом предложении вместе с единицами измерения, объясняет, что он меняет в проекте, и показывает код, который обрабатывает его правильно. Они коротки намеренно. Справочная страница, которую приходится перечитывать, со своей задачей не справилась.

По ним же студия предпочла бы, чтобы о ней судили, а не по портфолио. Лимит проверяется по собственной документации Telegram меньше чем за минуту, и любой, кто писал под этот API, по одному абзацу поймёт, писал ли автор. Это более медленный способ показать, что вы разбираетесь, чем стена клиентских логотипов, и заметно более долговечный.

Там, где лимит не опубликован, а мягкий — частота отправки тут самый ясный случай, — так и написано, без сглаживания. Строить на цифре, которую сам Telegram называет приблизительной, как на договорном обязательстве, — верный способ выпустить то, что работает на тестах и ломается на объёмах, ради которых всё затевалось.

Лимиты частоты и доставка

Потолки, определяющие, как быстро вообще может что-то происходить, и гарантии доставки, определяющие, не произойдёт ли это дважды. Большинство боевых инцидентов в этом ремесле начинается здесь.

Про сам справочник

Почему не читать просто официальную документацию Bot API?

Читать стоит, и эти страницы в неё ссылаются. Официальный справочник описывает, что каждый метод принимает и возвращает, — именно это справочник и должен делать, и это не то же самое, что сказать вам, что потолок отправки делает рассылку к точному времени невозможной, или что в 64 байта данных обратного вызова не влезут дата и идентификатор специалиста. Эти страницы про последствия.

Эти лимиты стабильны или меняются?

Структурные — размеры полезной нагрузки, ограничения на файлы, окно удаления — стабильны годами. Потолки частоты сам Telegram называет приблизительными и применяет адаптивно, поэтому здесь они поданы как цифры, под которые проектируют, а не как константы, на которые закладываются. Значимые изменения отслеживаются на странице изменений.

Код на этих страницах — боевой?

Это форма боевого кода, сведённая к той мысли, ради которой страница написана. Обработка ошибок, которой посвящена страница, показана целиком; та, что к делу не относится, опущена, чтобы пример оставался читаемым. Там, где что-то действительно несущее — сравнение за постоянное время при проверке init data, условная запись при выдаче слота, — это выписано, а не пересказано.

Какие из них реально создают проблемы на практике?

Примерно в таком порядке: потолки отправки, доставка не менее одного раза, 64 байта данных обратного вызова и таймаут перед подтверждением платежа. Первые два дают инциденты на объёме, третий — переделку в середине разработки, а четвёртый — сорванные платежи, которые выглядят как проблема платёжного провайдера и ею не являются.

Что почитать дальше