Частота запросов
Запросы сX-API-Key ограничиваются на ключ: устоявшийся темп —
10 запросов в секунду, кратковременный всплеск — до 20 запросов.
Превышение возвращает 429 Too Many Requests.
Ответ 429 несёт заголовок Retry-After — целое число секунд до момента,
когда лимит отпустит. Дождитесь этого времени, а если заголовка почему-то нет,
используйте экспоненциальную задержку: 1 с, 2 с, 4 с и так далее с небольшим
случайным разбросом.
- держите темп не выше 8–9 запросов в секунду, оставляя запас на ретраи;
- забирайте страницы по максимуму (
limit=1000), а не мелкими порциями; - при
429не продолжайте слать параллельные запросы — дождитесь окна.
Сроки жизни
Вебхук-доставка
- На каждое событие — до 8 попыток доставки с экспоненциально растущими интервалами, суммарно около суток.
- Успех — любой ответ
2xxза разумное время; всё остальное (таймаут,3xx,4xx,5xx) считается неуспехом и уходит в ретрай. - После 20 подряд окончательно проваленных доставок подписка автоматически отключается. Включить её обратно можно в настройках (Настройки → Интеграции → «Для разработчиков» → Вебхуки) — эндпоинта включения в API сейчас нет.
Размеры
- Пачка Ingest не ограничена жёстким числом записей, но держите её в пределах нескольких тысяч: обработка асинхронная, а тело запроса должно оставаться разумного размера (единицы мегабайт).
- Ответы списков ограничены пагинацией:
limitпо умолчанию100, максимум1000.