> ## Documentation Index
> Fetch the complete documentation index at: https://platform.doodocs.kz/llms.txt
> Use this file to discover all available pages before exploring further.

# Лимиты

> Частота запросов, сроки жизни ссылок и вебхук-доставки

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

Запросы с `X-API-Key` ограничиваются **на ключ**: устоявшийся темп —
**10 запросов в секунду**, кратковременный всплеск — до **20 запросов**.
Превышение возвращает `429 Too Many Requests`.

<Note>
  Заголовка `Retry-After` в ответе `429` сейчас нет — это ограничение preview.
  Используйте экспоненциальную задержку с самого начала: пауза 1 с, затем 2 с,
  4 с… с небольшим случайным разбросом.
</Note>

Практика для массовых выгрузок:

* держите темп не выше 8–9 запросов в секунду, оставляя запас на ретраи;
* забирайте страницы по максимуму (`page_size=100`), а не мелкими порциями;
* при `429` не продолжайте слать параллельные запросы — дождитесь окна.

## Сроки жизни

| Что                                      | Срок                                             | Что делать по истечении                                       |
| ---------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------- |
| Ссылка скачивания файла (`download_url`) | **1 час**                                        | Запросить эндпоинт скачивания повторно — придёт свежая ссылка |
| Секрет API-ключа                         | Показывается **один раз** при создании           | Создать новый ключ; восстановить секрет нельзя                |
| Секрет вебхука                           | Показывается **один раз** при создании эндпоинта | Пересоздать эндпоинт                                          |

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

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

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

Подробнее об устройстве доставки — в [справочнике вебхуков](/ru/api-reference/webhooks).

## Размеры

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