Документация для разработчиковНачало работы
Лимиты запросов и ограничения
Частота запросов, размер задания, параллельность и срок хранения.
Ниже — значения по умолчанию. GET /v1/limits возвращает значения для вашей организации.
| Лимит | Значение |
|---|---|
| Запросов в минуту / час / сутки | 60 / 1 000 / 5 000 |
Единиц груза в задании (сумма quantity) | 2 000 |
| Транспортных средств в задании (включая добавленные) | 20 |
| Бюджет времени вычислений на задание | 90 s |
| Одновременно рассчитываемых заданий | 1 |
| Заданий в очереди и в работе | 20 |
| Типы транспортных средств | truck, trailer, container, pallet |
| Тело запроса | 10 MB |
?wait | 60 s |
| Срок хранения тел запросов, результатов и ссылок на PDF | 14 дн. |
Лимиты запросов
Считаются по минутам, часам и суткам — для каждого ключа и для организации. Действует самый строгий.
| Заголовок | Значение |
|---|---|
X-RateLimit-Limit | Лимит самого строгого окна |
X-RateLimit-Remaining | Сколько запросов в нём осталось |
X-RateLimit-Reset | Время сброса окна (Unix) |
Retry-After | При 429: сколько секунд ждать |
При превышении лимита — 429 rate_limited. Если число неудачных попыток аутентификации с одного IP превысит 60 в минуту, ответ тоже будет 429.
Задания
Задания сверх лимита параллельности ждут в статусе queued. Если заданий в очереди и в работе больше 20, POST /v1/pack отвечает 429 too_many_jobs.
Срок хранения
Тела запросов и результатов, а также ссылки на PDF удаляются через 14 дн. (expires_at есть у каждого задания). Статус, счётчики и стоимость сохраняются.