오류 처리

배송조회 호환 API는 일부 업무 실패를 HTTP 200으로 반환합니다. 반드시 response body의 status와 code를 함께 확인하세요.

Code	HTTP	의미	권장 처리
`101`	`400`	API 키 누락·무효·종료	키 전달과 상태 확인
`102`	`200`	이용권 기간 만료	유효한 이용권 준비
`103`	`200`	이용권 제공량 소진	새 이용권 준비
`104`	`200`	택배사 code 또는 운송장 입력 오류	company list와 입력값 확인
`105`	`200`	동일 대상 일일 20회 초과	다음 날까지 polling 중단
`106`	`200`	배송조회 처리 오류	잠시 뒤 제한적으로 재시도

{
  "status": false,
  "msg": "동일한 운송장의 하루 요청 건수를 초과 하였습니다.",
  "code": "105"
}

<?xml version="1.0" encoding="UTF-8"?>
<Result>
  <status>false</status>
  <message>동일한 운송장의 하루 요청 건수를 초과 하였습니다.</message>
  <Code>105</Code>
</Result>

HTTP 오류

406: 요청한 Accept 형식을 지원하지 않습니다.
404: key/usage에서 API 키 또는 연결된 이용권을 찾을 수 없습니다.
500: 내부 오류입니다. body를 parsing하거나 오류 세부정보에 의존하지 말고 지수 backoff로 제한적으로 재시도하세요.

POST 배송조회도 request body validation 오류를 사용하지 않습니다. 세 값은 모두 query parameter이며, 누락·중복·형식 오류는 호환 오류로 변환됩니다.

HTTP 오류

On this page