이용량과 제한
이용권의 제공량, 기간과 배송조회 일일 제한을 설명합니다.
API 키는 하나의 이용권에 연결됩니다. 이용권은 전체 제공량, 남은 제공량, 시작일과 종료일을 가집니다.
GET /api/v1/key/usage로 현재 값을 확인할 수 있습니다.
제공량 차감
- 새로운 배송조회 대상은 사용할 수 있는 이용권의 잔여량을 차감합니다.
- 남은 제공량이 없으면 오류
103을 반환합니다. - 이용권 기간이 끝나면 오류
102를 반환합니다. - carrier 처리 실패 등 완료되지 않은 조회에는 제공량이 차감되지 않을 수 있습니다.
동일 대상 일일 제한
동일한 API 키, 택배사 code와 운송장 번호 조합은 하루 최대 20회 조회할 수 있습니다. 21번째 요청부터
오류 105를 반환합니다. application의 polling 주기를 조절하고 같은 결과를 불필요하게 반복 요청하지
마세요.
날짜와 시간
이용량 응답의 startDate, endDate는 YYYY-MM-DD HH:mm:ss 문자열입니다. 현재 계약에는 timezone
offset이 포함되지 않으므로 표시·비교 시 서비스 운영 timezone 기준을 일관되게 적용하세요.