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