API
배송조회 (POST)
POST /api/v1/trackingInfo
GET과 동일한 배송조회 기능을 POST method로 호출합니다. 세 입력은 모두 query parameter이며 request body를 보내지 않습니다.
요청
| Parameter | 위치 | 필수 | 설명 |
|---|---|---|---|
t_key | query | 예 | 발급받은 API 키 원문 |
t_code | query | 예 | company list의 택배사 code |
t_invoice | query | 예 | ASCII 숫자로 된 운송장 번호, 최대 64자 |
curl --request POST \
--get "$TAEKMANI_BASE_URL/api/v1/trackingInfo" \
--data-urlencode "t_key=$TAEKMANI_API_KEY" \
--data-urlencode "t_code=04" \
--data-urlencode "t_invoice=000000000000" \
--header "Accept: application/json"JSON body를 보내지 마세요
Content-Type: application/json body는 이 operation의 입력 계약이 아닙니다. GET과 같은 query
parameter를 사용하세요.
JSON 응답 예시
아직 조회되지 않은 운송장의 호환 응답 예시입니다.
{
"adUrl": null,
"complete": false,
"invoiceNo": "000000000000",
"itemImage": null,
"itemName": "",
"level": 0,
"receiverAddr": "",
"receiverName": "",
"recipient": "",
"result": "N",
"senderName": "",
"trackingDetails": [],
"orderNumber": null,
"estimate": null,
"productInfo": null,
"zipCode": null,
"lastDetail": null,
"lastStateDetail": null,
"firstDetail": null,
"completeYN": "N"
}XML 응답 예시
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<tracking_info>
<complete>false</complete>
<invoice_no>000000000000</invoice_no>
<item_name></item_name>
<level>0</level>
<reciver_addr></reciver_addr>
<reciver_name></reciver_name>
<recipient></recipient>
<result>N</result>
<sender_name></sender_name>
<complete>N</complete>
</tracking_info>정상·오류 response 계약, 이용권 차감과 동일 대상 일일 20회 제한은 GET operation과 같습니다. timeout 뒤 응답을 받지 못했다고 즉시 같은 요청을 반복하지 말고 제한적인 재시도 정책을 적용하세요.
상태 코드
| HTTP | 설명 |
|---|---|
200 | 배송 결과 또는 업무 오류 102~106 |
400 | 오류 101: API 키 누락 또는 무효 |
406 | 지원하지 않는 응답 형식 |
500 | 내부 오류, body 없음 |