Лимиты и размеры
Ограничения частоты запросов и максимальные размеры тел в GetMyBot API.
На этой странице
Чтобы платформа оставалась стабильной, у API есть ограничения на частоту запросов и на размер передаваемых данных. Ограничения конструктора (ключевые слова, циклы, веб-запросы, выгрузки) собраны на странице Лимиты платформы.
Частота запросов
При превышении допустимой частоты запросов сервер отвечает кодом 429 Too Many Requests. Правильная реакция: повтор с экспоненциальной задержкой (backoff): увеличивайте паузу между повторами и не шлите запросы плотным потоком. Распределяйте массовые операции во времени и переиспользуйте один токен последовательно, а не параллельными всплесками.
Размер тела запроса
Для обычных REST-запросов размер JSON-тела ограничен 2 MiB. Этого достаточно для любых конфигураций реакций, коллекций и настроек. Если тело крупнее: разбейте операцию на части (например, импортируйте реакции пакетами).
Размер тела при импорте
Эндпоинты импорта рассчитаны на большие бандлы и имеют отдельные, более высокие лимиты: до 64 MiB для импорта данных и до 256 MiB для импорта с вложенным медиа. Если бандл больше: делите его на несколько импортов.
Превышение лимитов
- Превышен лимит частоты:
429, повтор с задержкой. - Тело больше допустимого: запрос отклоняется (
413или400в зависимости от эндпоинта); уменьшите или разбейте полезную нагрузку.
Что дальше
- Ошибки: про
429и другие коды. - Импорт из sambot: про большие бандлы импорта.
- Интерактивный справочник: лимиты конкретных эндпоинтов.