택배 API란?
택배 API는 프로그램에서 택배사의 배송 정보를 조회하거나 택배 접수를 할 수 있게 해주는 인터페이스입니다. 쇼핑몰, 물류 시스템 등에서 송장번호로 배송 상태를 자동으로 확인할 때 사용합니다.
쉽게 이해하기
택배사 웹사이트에서 송장번호를 입력하면 배송 상태를 볼 수 있죠? 택배 API는 이 과정을 사람이 아닌 프로그램이 자동으로 할 수 있게 해줍니다.
비유로 이해하기
식당에서 직접 주문하는 것 = 택배사 웹사이트에서 조회
배달앱으로 주문하는 것 = 택배 API로 조회
배달앱(API)을 통하면 여러 식당(택배사)을 한 곳에서 이용할 수 있습니다.
택배 API가 필요한 이유
- 자동화 - 수천 건의 배송을 일일이 조회할 수 없음
- 통합 - 여러 택배사를 하나의 방식으로 처리
- 실시간 - 배송 상태 변경 시 즉시 알림 가능
- 고객 경험 - 내 사이트에서 바로 배송 조회 제공
택배 API 동작 원리
1. 요청 (Request)
프로그램에서 택배사 코드와 송장번호를 API 서버로 보냅니다.
POST /v1/tracking/trace
Content-Type: application/json
{"items": [
{"courierCode": "cj", "trackingNumber": "1234567890" }
]
} 2. 응답 (Response)
API 서버가 배송 정보를 JSON 형식으로 돌려줍니다. 자세한 응답 형식은 API 문서를 참고하세요.
택배 API 종류
배송 조회 API
송장번호로 현재 배송 상태와 이동 경로를 조회합니다. 가장 기본적이고 많이 사용됩니다.
택배 접수 API
프로그램에서 직접 택배 접수를 합니다. 송장번호 발급, 집하 예약 등이 가능합니다.
웹훅 (실시간 알림)
배송 상태가 변경되면 자동으로 알려주는 기능입니다. 매번 조회하지 않아도 됩니다.
활용 예시
- 쇼핑몰 - 마이페이지에서 배송 조회, 주문 상태 자동 업데이트
- WMS - 출고 후 배송 추적, 반품 모니터링
- 알림 서비스 - 배송 출발/완료 시 카카오톡 알림
- CS 시스템 - 고객 문의 시 배송 상태 즉시 확인