​

오류 및 재시도 동작

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

​

재시도 가이드

• 전송(transport) 실패는 재시도하세요.
• 멱등성 있는 쓰기 작업은 동일한 Idempotency-Key로 재시도하세요.
• 첫 번째 응답이 완료되었다고 가정하지 말고, 비동기 작업 이후에는 내구 상태(durable state)를 다시 읽으세요.

​

실용 규칙

• 서버 측 실패는 원래의 쓰기 작업이 안정적인 멱등성 키를 사용한 경우에만 재시도 대상으로 취급하세요.
• 새로운 export 다운로드 URL은 임시로 취급하고, 필요할 때 GET /exports/{exportId}에서 다시 읽어오세요.
• 변경 작업(mutation)이 이미 진행 중이거나 현재 상태와 충돌하는 경우, 반환된 code를 확인하고 작업이 논리적으로 여전히 안전할 때만 재시도하세요.

​

기계 판독형 클라이언트

• code
• message
• status
• retryable