Перейти к основному содержанию

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

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

Сроки жизни

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

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

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

Размеры

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