Skip to main content

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

Запросы с X-API-Key ограничиваются на ключ: устоявшийся темп — 10 запросов в секунду, кратковременный всплеск — до 20 запросов. Превышение возвращает 429 Too Many Requests.
Заголовка Retry-After в ответе 429 сейчас нет — это ограничение preview. Используйте экспоненциальную задержку с самого начала: пауза 1 с, затем 2 с, 4 с… с небольшим случайным разбросом.
Практика для массовых выгрузок:
  • держите темп не выше 8–9 запросов в секунду, оставляя запас на ретраи;
  • забирайте страницы по максимуму (page_size=100), а не мелкими порциями;
  • при 429 не продолжайте слать параллельные запросы — дождитесь окна.

​
Сроки жизни

Не сохраняйте download_url в базу и не встраивайте в письма — через час ссылка перестанет работать. Храните id файла и запрашивайте ссылку в момент скачивания.

​
Вебхук-доставка

  • На каждое событие — до 8 попыток доставки с экспоненциально растущими интервалами, суммарно около суток.
  • Успех — любой ответ 2xx за разумное время; всё остальное (таймаут, 3xx, 4xx, 5xx) считается неуспехом и уходит в ретрай.
  • После 20 подряд окончательно проваленных доставок эндпоинт автоматически отключается. Включить его обратно можно в настройках (Интеграции → Вебхуки) — эндпоинта включения в API сейчас нет.
Подробнее об устройстве доставки — в справочнике вебхуков.

​
Размеры

  • Пачка Ingest не ограничена жёстким числом записей, но держите её в пределах нескольких тысяч: обработка асинхронная, а тело запроса должно оставаться разумного размера (единицы мегабайт).
  • Ответы списков ограничены пагинацией — page_size до 100.