API-ключи и ограничения запросов
Версия 2.7
Ключ и область доступа
Ключ создаётся в «Настройки → Интеграции». Для чтения статусов используйте область shipments:read. Для создания отправления нужна shipments:write. Сервер передаёт ключ в заголовке Authorization как Bearer. Храните его в серверном хранилище секретов.
Ответ 429 и повтор
Публичный API допускает 120 запросов в минуту на ключ. При превышении API возвращает HTTP 429 и Retry-After в секундах. Дождитесь указанного времени, затем повторите запрос с ограниченной экспоненциальной задержкой.
Повтор создания отправления
Для повторной отправки запроса создания используйте тот же Idempotency-Key и то же тело. Запись ключа хранится 24 часа. При несовпадении тела с ранее сохранённым запросом API вернёт 409.