Ошибки

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

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

{
  "success": false,
  "error": {
    "id": "validation.partner_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.