오류와 재시도

모든 오류를 같은 방식으로 재시도하면 중복 적재나 장애 확산이 생길 수 있습니다. 상태 코드, 요청 ID, 작업의 멱등성을 함께 확인하세요.

기본 대응

• 401은 개발자 키·workspace·조직 헤더를 확인하고 자동 재시도하지 않습니다.
• 잘못된 요청은 payload를 수정한 뒤 다시 보냅니다.
• 429는 응답의 Retry-After 초만큼 기다린 뒤 지수 backoff로 재시도합니다.
• 503은 일시적인 API/DB 장애일 수 있으므로 제한된 횟수만 재시도합니다.
• 네트워크 timeout은 요청이 서버에 도달했을 가능성을 고려해 중복 방지 키를 사용합니다.

기록할 값: timestamp, endpoint, status, request_id, retry_count
기록하지 않을 값: token, 비밀번호, 전체 개인정보 payload

오류 응답은 { "error": { "code": "...", "message": "..." } } 형태입니다. 전체 상태 코드와 schema는 현재 사용 중인 API base URL의 /external-openapi.json을 기준으로 합니다.