배송 추적 API,
한 번의 연동으로 끝.
택배사 마다 배송 상태 조회를 연동할 필요없습니다. TheTrack API 하나로 모든 택배사의 배송 상태를 조회하세요.
curl -X GET "https://api.thetrack.kr/v1/track\
?carrier=cjlogistics\
&trackingNumber=1234567890" \
-H "X-API-Key: your_api_key"
# Response
{
"code": "200",
"data": {
"carrier": { "id": "cjlogistics", "name": "CJ대한통운" },
"trackingNumber": "1234567890",
"lastEvent": {
"status": "DELIVERED",
"statusText": "배송완료",
"time": "2026-03-25 14:30:00",
"location": "서울 강남구"
},
"events": [...],
"templateUrl": "https://www.thetrack.kr/tracking/cjlogistics/1234567890?sig=6SWoNPGdwC9GQLqoQb2Vff6hGXvn5hF7rh1SPgQBzLnnxvVdkNm3wfVeUcDxGbKydf"
}
}개발자를 위한 배송 추적
복잡한 택배사 연동을 TheTrack이 대신합니다.
택배사 통합
CJ대한통운, 한진, 롯데, 우체국부터 DHL, FedEx까지. 국내외 주요 택배사를 단일 API로 조회합니다.
실시간 상태 추적
집하부터 배송 완료까지 모든 이벤트를 실시간으로 반환합니다. 표준화된 상태 코드로 일관된 처리가 가능합니다.
5분 만에 연동
RESTful API 한 줄이면 충분합니다. cURL, Python, Node.js 등 어떤 환경에서든 바로 사용할 수 있습니다.
안정적 인프라
배송정보를 요청 즉시 실시간으로 조회하여 제공합니다.
3단계로 시작
회원가입
이메일로 가입하고 대시보드에서 API 키를 발급받으세요. 무료 이용권으로 바로 시작할 수 있습니다.
API 연동
발급받은 API 키를 헤더에 넣고 요청하면 됩니다. SDK 없이 HTTP 요청만으로 충분합니다.
배송 조회
택배사 코드와 운송장 번호만 전달하면 표준화된 JSON 응답을 받습니다.
합리적인 이용요금
건수별 볼륨 단가로 충전하는 이용권입니다. 많이 쓸수록 건당 단가가 내려갑니다. 동일 운송장은 30일 이내 여러 번 조회해도 1건만 차감됩니다. (부가세 별도)
배송조회 페이지를 즉시 제공하세요
별도 개발 없이 URL 하나로 고객에게 배송조회 화면을 제공합니다.
CJ대한통운
1234567890
서울 강남구
강남 배송센터
강남 집중국
대전 허브
CJ대한통운
1234567890
● 배송완료
배송완료
서울 강남구
배송출발
강남 배송센터
도착
강남 집중국
발송
대전 허브
집하
부산 해운대
CJ대한통운
1234567890
서울 강남구
강남 배송센터
강남 집중국
대전 허브
주요 특징
API 응답의 templateUrl로 바로 사용
조회 응답 data.templateUrl은 서명(sig)이 포함된 완성된 배송조회 링크입니다. 그대로 고객에게 전달하면 됩니다.
iframe 한 줄 임베드
쇼핑몰, 앱 등 어디서나 iframe 한 줄로 즉시 삽입합니다. 화면 구현이 필요 없습니다.
3가지 테마
링크 끝에 &theme= 만 붙이면 스타일이 바뀝니다.
모바일 반응형
스마트폰, 태블릿, PC 모든 화면에서 최적화된 레이아웃을 제공합니다.
위변조 방지 - sig 서명
sig(서명)로 링크를 검증해, 변조된 링크의 조회는 거부됩니다.