Лимиты запросов

20 запросов в секунду на ключ, заголовки лимита в каждом ответе, 429 с Retry-After.

Каждый API-ключ может делать 20 запросов в секунду (фиксированное секундное окно, общее для всех наших серверов). Аккаунт-менеджер может повысить лимит для вашей организации.

В каждом ответе — состояние окна:

HTTP/1.1 200 OK
X-RateLimit-Limit: 20
X-RateLimit-Remaining: 17
X-Request-Id: 0192f1c3-9e8d-7f6a-b5c4-d3e2f1a0b9c8

Сверх лимита запрос отклоняется, ничего не выполняя:

HTTP/1.1 429 Too Many Requests
Retry-After: 1
Content-Type: application/problem+json

{"status": 429, "code": "rate_limited", "message": "Слишком много запросов, повторите позже", "details": [], "request_id": "…"}

Трекинг ограничен на заказ

GET /v1/orders/{id}/track можно вызывать раз в 10 секунд на заказ; чаще — 429 с Retry-After. Позиция курьера чаще и не меняется, а для получателя есть страница отслеживания (ссылки отслеживания).

Хорошие практики

• Ждите Retry-After секунд перед повтором после 429; добавляйте случайную задержку, если повторяют много воркеров.
• Используйте вебхуки вместо опроса: одно событие вместо десятков GET /orders/{id}.
• Для массовой загрузки — POST /v1/orders/batch (до 100 заказов).
• Заводите отдельные ключи для разных систем — лимит считается на ключ.