Лимиты и размеры

Чтобы платформа оставалась стабильной, у API есть ограничения на частоту запросов и на размер передаваемых данных.

Частота запросов

При превышении допустимой частоты запросов сервер отвечает кодом 429 Too Many Requests. Правильная реакция — повтор с экспоненциальной задержкой (backoff): увеличивайте паузу между повторами и не шлите запросы плотным потоком. Распределяйте массовые операции во времени и переиспользуйте один токен последовательно, а не параллельными всплесками.

Размер тела запроса

Для обычных REST-запросов размер JSON-тела ограничен 2 MiB. Этого достаточно для любых конфигураций реакций, коллекций и настроек. Если тело крупнее — разбейте операцию на части (например, импортируйте реакции пакетами).

Размер тела при импорте

Эндпоинты импорта рассчитаны на большие бандлы и имеют отдельные, более высокие лимиты: до 64 MiB для импорта данных и до 256 MiB для импорта с вложенным медиа. Если бандл больше — делите его на несколько импортов.

Превышение лимитов

  • Превышен лимит частоты — 429, повтор с задержкой.
  • Тело больше допустимого — запрос отклоняется (413 или 400 в зависимости от эндпоинта); уменьшите или разбейте полезную нагрузку.

Что дальше