​

Ошибки и поведение при повторных попытках

{
  "error": {
    "code": "SOME_CODE",
    "message": "Human-readable explanation",
    "issues": []
  }
}

​

Рекомендации по повторным попыткам

• Повторяйте попытки при сбоях транспорта.
• Повторяйте идемпотентные записи с тем же Idempotency-Key.
• После асинхронной работы перечитывайте устойчивое состояние, вместо того чтобы считать первый ответ окончательным.

​

Практические правила

• Рассматривайте серверные сбои как кандидатов на повтор только когда исходная запись использовала стабильный ключ идемпотентности.
• Считайте новые URL для скачивания экспорта временными и при необходимости перечитывайте их через GET /exports/{exportId}.
• Если мутация уже выполняется или конфликтует с текущим состоянием, проверьте возвращённый code и повторяйте только когда операция всё ещё логически безопасна.

​

Клиенты, читаемые машиной

• code
• message
• status
• retryable