Ошибки

Ошибки валидации

Ответ 400 перечисляет все проблемные поля сразу:

{
  "success": false,
  "error": {
    "id": "validation.delivery_payload_invalid",
    "message": "dropoffs.0.address.latitude: latitude is required",
    "details": "[{\"field\":\"dropoffs.0.address.latitude\",\"message\":\"latitude is required\"}]"
  }
}

details — это JSON-массив объектов { field, message }. Путь до поля записывается через точку, с индексами массивов: dropoffs.0.address.latitude.

Коды ответов

Код	Значение
400	Запрос отклонён. Подробности — в error.details.
401	Ключ отсутствует, повреждён, отозван — либо его аккаунт больше не может создавать заказы.
404	Заказа с таким external_order_id нет.
409	Параллельный запрос уже создаёт этот заказ. Повторите позже.
429	Превышен лимит запросов для ключа.

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

Лимит считается для каждого ключа отдельно, за минуту. Текущее значение видно в ответе GET /ping — поле rate_limit_per_minute.

Получив 429, подождите и повторите запрос, каждый раз увеличивая интервал.

Что делать при 401

Ответ 401 не всегда означает опечатку в ключе. Он приходит и тогда, когда:

• ключ отозван в личном кабинете;
• аккаунт владельца отключён;
• владелец больше не является клиентом и не может создавать заказы.

Проверить ключ можно запросом GET /ping.