Ліміти і розміри

Щоб платформа залишалася стабільною, у API є обмеження на частоту запитів і на розмір переданих даних.

Частота запитів

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

Розмір тіла запиту

Для звичайних REST-запитів розмір JSON-тіла обмежений 2 МіБ. Цього достатньо для будь-яких конфігурацій реакцій, колекцій і налаштувань. Якщо тіло більше — розбийте операцію на частини (наприклад, імпортуйте реакції пакетами).

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

Ендпоінти імпорту розраховані на великі бандли і мають окремі, вищі ліміти: до 64 МіБ для імпорту даних і до 256 МіБ для імпорту з вбудованим медіа. Якщо бандл більший — діліть його на кілька імпортів.

Перевищення лімітів

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

Що далі