{"swagger":"2.0","info":{"description":"
\n
\n
\n
개요
\n
스마트택배 배송조회 API는 국내외 주요 배송사의 실시간 택배 배송정보를 RESTful 형태로 제공하고 있습니다.
\n
연동방식
\n \n
Client 는 REST API 규격에 맞춰 배송정보를 요청합니다.
\n
연동 택배사 코드
\n
국내택배(73개사)
\n
\n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n \n
택배사코드택배사코드택배사코드
우체국택배01CJ대한통운04한진택배05
로젠택배06롯데택배08일양로지스11
한의사랑택배16천일택배17건영택배18
한진택배B2B20대신택배22경동택배23
GS Postbox 택배24합동택배32애니트랙43
SLX택배44우리택배(구호남택배)45CU편의점택배46
농협택배53홈픽택배54IK물류71
성훈물류72CR로지텍73용마로지스74
원더스퀵75컬리넥스트마일82풀앳홈85
두발히어로89위니아딤채90지니고 당일배송92
카카오 T 당일배송94트랙스로지스95나은물류100
한샘서비스101도도플렉스(dodoflex)104LG전자107
썬더히어로113롯데칠성118핑퐁119
발렉스 특수물류120엔티엘피스123지케이글로벌125
로지스팟127홈픽 오늘도착129로지스파트너130
딜리래빗131지오피132에이치케이홀딩스134
HTNS135케이제이티136더바오137
라스트마일138탱고앤고142투데이143
ARGO(테크타카)148HY155유피로지스(제주)156
반얀로지스틱스157프리즘코리아160위니온163
딜리박스167이스트라168올인닷컴171
물류대장(택배)173풀무원샘물㈜175SLO(모든)179
바로스183레터스186벤더피아187
세븐일레븐 착한택배189물류대장(설치)190BoxN191
리터니즈192
\n
\n
국제택배(59개사)
\n
\n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n \n
택배사코드택배사코드택배사코드
EMS12DHL13UPS14
Fedex21TNT Express25GSMNtoN28
KGL네트웍스30LX판토스37ECMS Express38
GSI Express41CJ대한통운 국제특송42ACI Express48
A.C.E EXPRESS INC49GPS Logix50성원글로벌카고51
EuroParcel55YJS글로벌(영국)60은하쉬핑63
YJS글로벌(월드)65Giant Network Group66대림통운69
LOTOS CORPORATION70LineExpress77제니엘시스템81
스마트로지스84이투마스(ETOMARS)87하이브시티91
팬스타국제특송(PIEX)93에이씨티앤코아물류97롯데택배 해외특송99
SHIPNERGY102브릿지로지스㈜105캐나다쉬핑114
YUNDA EXPRESS117바바바(bababa)121BAIMA EXPRESS122
LTL124판월드로지스틱128직구문140
인터로지스141큐브플로우(CUBEFLOW)144국제로지스틱(KSE)146
에스더쉬핑147골드스넵스149자이언트151
엠티인터내셔널152이지로지스틱153케이티익스프레스154
AusPost158SAP EXPRESS162서림특송165
Rincos166JNT169티에스지로지스177
지씨에스182윤익스프레스(YunExpress)185CXCExpress188
Line Clear194컨트롤로지스195
\n
\n
전문규격
\n
HTTP METHOD
\n
전송 요청을 위한 HTTP GET/POST 방식을 제공하며, 전송 응답은 XML/JSON 방식을 사용합니다.
\n
ENCODING
\n
UTF-8 인코딩을 기본으로 제공합니다.
\n
TIMEZONE
\n
배송 정보에 사용된 시간은 한국 표준시 KST(UTC+9)를 사용합니다.
\n
REST API 스펙
\n
Base Url
\n 
https://info.sweettracker.co.kr
\n
\n
\n
","version":"1.0.0","title":"스마트택배 배송조회 API Doc","contact":{},"license":{}},"host":"info.sweettracker.co.kr","basePath":"/","tags":[{"name":"운송장 배송 조회","description":" "},{"name":"이용권 정보 조회","description":" "},{"name":"추천 택배사 목록 조회","description":" "},{"name":"택배사 목록 조회","description":" "}],"paths":{"/api/v1/companylist":{"get":{"tags":["택배사 목록 조회"],"summary":"택배사 조회","description":"Response code 404 일 경우 response body 의 code 와 메시지 확인 바랍니다","operationId":"getCompanyListUsingGET","produces":["application/json;charset=UTF-8","application/xml;charset=UTF-8"],"parameters":[{"name":"t_key","in":"query","description":"발급받은 키","required":true,"type":"string"}],"responses":{"200":{"description":"택배사 조회 정상","schema":{"$ref":"#/definitions/Companies"}},"404":{"description":"code 와 msg 정보 확인 바랍니다.","schema":{"$ref":"#/definitions/Status"}},"500":{"description":"서버 에러 입니다","schema":{"$ref":"#/definitions/Status"}}}}},"/api/v1/key/usage":{"get":{"tags":["이용권 정보 조회"],"summary":"이용권 사용량 조회","description":"API Key의 현재 이용량을 조회합니다.","operationId":"getAPIKeyUsageUsingGET","produces":["*/*"],"parameters":[{"name":"key","in":"header","description":"사용 중인 API Key","required":true,"type":"string"}],"responses":{"200":{"description":"이용권 사용량 조회","schema":{"$ref":"#/definitions/APIKeyUsage"}},"404":{"description":"존재하지 않는 API Key 정보"},"500":{"description":"서버 에러"}}}},"/api/v1/recommend":{"get":{"tags":["추천 택배사 목록 조회"],"summary":"추천 택배사 정보 가져오기","description":"Response code 404 일 경우 response body 의 code 와 메시지 확인 바랍니다","operationId":"getRecommendCompanyUsingGET_1","produces":["application/json;charset=UTF-8","application/xml;charset=utf8"],"parameters":[{"name":"t_invoice","in":"query","description":"운송장 번호","required":true,"type":"string"},{"name":"t_key","in":"query","description":"발급받은 키","required":true,"type":"string"}],"responses":{"200":{"description":"택배사 추천 정보 조회 정상","schema":{"$ref":"#/definitions/Companies"}},"404":{"description":"code 와 msg 정보 확인 바랍니다.","schema":{"$ref":"#/definitions/Status"}},"500":{"description":"서버 에러 입니다","schema":{"$ref":"#/definitions/Status"}}}}},"/api/v1/trackingInfo":{"get":{"tags":["운송장 배송 조회"],"summary":"운송장 배송 조회","description":"Response code 404 일 경우 response body 의 code 와 msg 확인 바랍니다","operationId":"getInvoiceInfoUsingGET","produces":["application/json;charset=UTF-8","application/xml;charset=utf8"],"parameters":[{"name":"t_code","in":"query","description":"택배사 코드","required":true,"type":"string"},{"name":"t_invoice","in":"query","description":"운송장 번호","required":true,"type":"string"},{"name":"t_key","in":"query","description":"발급받은 키","required":true,"type":"string"}],"responses":{"101":{"description":"발급된 고유키가 존재 하지 않음","schema":{"$ref":"#/definitions/Status"}},"102":{"description":"만료된 키","schema":{"$ref":"#/definitions/Status"}},"103":{"description":"키 사용량 초과","schema":{"$ref":"#/definitions/Status"}},"104":{"description":"유효하지 않은 운송장 번호 혹은 택배사 코드 입력","schema":{"$ref":"#/definitions/Status"}},"105":{"description":"동일한 운송장의 하루 요청 제한 건수 초과","schema":{"$ref":"#/definitions/Status"}},"106":{"description":"운송장 번호 조회 에러","schema":{"$ref":"#/definitions/Status"}},"200":{"description":"운송장 번호 조회 결과 정상","schema":{"$ref":"#/definitions/TrackingInfo"}},"404":{"description":"code 와 msg 정보 확인 바랍니다.","schema":{"$ref":"#/definitions/Status"}},"500":{"description":"서버 에러 입니다","schema":{"$ref":"#/definitions/Status"}}}},"post":{"tags":["운송장 배송 조회"],"summary":"운송장 배송 조회","description":"Response code 404 일 경우 response body 의 code 와 msg 확인 바랍니다","operationId":"getInvoiceInfoUsingPOST","consumes":["application/json"],"produces":["application/json;charset=UTF-8","application/xml;charset=utf8"],"parameters":[{"name":"t_code","in":"query","description":"택배사 코드","required":true,"type":"string"},{"name":"t_invoice","in":"query","description":"운송장 번호","required":true,"type":"string"},{"name":"t_key","in":"query","description":"발급받은 키","required":true,"type":"string"}],"responses":{"101":{"description":"발급된 고유키가 존재 하지 않음","schema":{"$ref":"#/definitions/Status"}},"102":{"description":"만료된 키","schema":{"$ref":"#/definitions/Status"}},"103":{"description":"키 사용량 초과","schema":{"$ref":"#/definitions/Status"}},"104":{"description":"유효하지 않은 운송장 번호 혹은 택배사 코드 입력","schema":{"$ref":"#/definitions/Status"}},"105":{"description":"동일한 운송장의 하루 요청 제한 건수 초과","schema":{"$ref":"#/definitions/Status"}},"106":{"description":"운송장 번호 조회 에러","schema":{"$ref":"#/definitions/Status"}},"200":{"description":"운송장 번호 조회 결과 정상","schema":{"$ref":"#/definitions/TrackingInfo"}},"404":{"description":"code 와 msg 정보 확인 바랍니다.","schema":{"$ref":"#/definitions/Status"}},"500":{"description":"서버 에러 입니다","schema":{"$ref":"#/definitions/Status"}}}}}},"definitions":{"APIKeyUsage":{"type":"object","properties":{"endDate":{"type":"string","description":"이용권 종료 시각"},"key":{"type":"string","description":"API Key"},"leftAmount":{"type":"integer","format":"int32","description":"잔여 사용량"},"startDate":{"type":"string","description":"이용권 시작 시각"},"totalAmount":{"type":"integer","format":"int32","description":"총 사용량"}},"title":"APIKeyUsage"},"Companies":{"type":"object","properties":{"Code":{"type":"string","description":"택배 회사 코드"},"International":{"type":"string","description":"국제 택배 지원 여부"},"Name":{"type":"string","description":"택배 회사 이름"}},"title":"Companies"},"Status":{"type":"object","properties":{"code":{"type":"string"},"msg":{"type":"string"},"status":{"type":"boolean"}},"title":"Status"},"TrackingDetail":{"type":"object","properties":{"code":{"type":"string","description":"배송상태 코드"},"kind":{"type":"string","xml":{"name":"trans_kind","attribute":false,"wrapped":false},"description":"진행상태"},"level":{"type":"integer","format":"int32","description":"진행단계"},"manName":{"type":"string","description":"배송기사 이름"},"manPic":{"type":"string","description":"배송기사 사진"},"remark":{"type":"string","description":"비고"},"telno":{"type":"string","xml":{"name":"trans_telno","attribute":false,"wrapped":false},"description":"진행위치(지점)전화번호"},"telno2":{"type":"string","xml":{"name":"trans_telno2","attribute":false,"wrapped":false},"description":"배송기사 전화번호"},"time":{"type":"integer","format":"int64","xml":{"name":"trans_time","attribute":false,"wrapped":false},"description":"진행시간"},"timeString":{"type":"string","description":"진행시간"},"where":{"type":"string","xml":{"name":"trans_where","attribute":false,"wrapped":false},"description":"진행위치지점"}},"title":"TrackingDetail","xml":{"name":"tracking_details","attribute":false,"wrapped":false}},"TrackingInfo":{"type":"object","properties":{"adUrl":{"type":"string","description":"택배사에서 광고용으로 사용하는 주소"},"complete":{"type":"boolean","description":"배송 완료 여부(true or false)"},"completeYN":{"type":"string","xml":{"name":"complete","attribute":false,"wrapped":false},"description":"배송 완료 여부(Y or N)"},"estimate":{"type":"string","description":"배송예정 시간"},"firstDetail":{"description":"배송 시작 정보","$ref":"#/definitions/TrackingDetail"},"invoiceNo":{"type":"string","xml":{"name":"invoice_no","attribute":false,"wrapped":false},"description":"운송장 번호"},"itemImage":{"type":"string","description":"상품이미지 url"},"itemName":{"type":"string","xml":{"name":"item_name","attribute":false,"wrapped":false},"description":"상품 이름"},"lastDetail":{"description":"배송 완료후 정보","$ref":"#/definitions/TrackingDetail"},"lastStateDetail":{"description":"배송 완료후 정보","$ref":"#/definitions/TrackingDetail"},"level":{"type":"integer","format":"int32","description":"진행단계 [level 1: 배송준비중, 2: 집화완료, 3: 배송중, 4: 지점 도착, 5: 배송출발, 6:배송 완료]"},"orderNumber":{"type":"string","description":"주문 번호"},"productInfo":{"type":"string","description":"상품정보"},"receiverAddr":{"type":"string","xml":{"name":"reciver_addr","attribute":false,"wrapped":false},"description":"받는 사람 주소"},"receiverName":{"type":"string","xml":{"name":"reciver_name","attribute":false,"wrapped":false},"description":"받는 사람"},"recipient":{"type":"string","description":"수령인 정보"},"result":{"type":"string","description":"조회 결과"},"senderName":{"type":"string","xml":{"name":"sender_name","attribute":false,"wrapped":false},"description":"보내는 사람"},"trackingDetails":{"type":"array","xml":{"name":"tracking_details","attribute":false,"wrapped":false},"description":"상세 정보","items":{"$ref":"#/definitions/TrackingDetail"}},"zipCode":{"type":"string","description":"우편번호"}},"title":"TrackingInfo","xml":{"name":"tracking_info","attribute":false,"wrapped":false}}}}