오류와 재시도

오류는 defined·code·status·message와 선택적 data를 포함합니다. message의 문장 일치 대신 HTTP 상태 코드와 code로 처리합니다. 실제 data는 오류마다 다릅니다.

상황	대응
400	필드·타입·헤더·쿼리 파라미터 수정
401	API 인증 정보가 접속 환경에 맞고 올바르게 설정됐는지 확인
403	접근 권한과 고객사 설정 확인
404	저장한 ID와 조회 가능한 대상 확인. 다른 고객사 대상도 같은 404
409	최신 상태 조회 후 실행 가능 여부 재판단
422	예약 부족 등 업무 조건이나 멱등 키 사용 방식 수정
429	Retry-After의 초만큼 대기하고 간격에 변동을 넣어 같은 키로 재시도
타임아웃·5xx	서버가 이미 요청을 처리했을 수 있으므로 결과 조회 후 같은 키·같은 입력으로 재시도

503에 Retry-After가 있어도 그 값을 따릅니다. 문의할 때는 환경, HTTP 메서드·요청 경로, 발생 시각, HTTP 상태 코드·code, 응답 헤더의 x-request-id를 전달합니다. API 인증 정보와 웹훅 서명 키는 공유 로그에 포함하지 않습니다.