용어 사전

택배 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

프로그램에서 직접 택배 접수를 합니다. 송장번호 발급, 집하 예약 등이 가능합니다.

웹훅 (실시간 알림)

배송 상태가 변경되면 자동으로 알려주는 기능입니다. 매번 조회하지 않아도 됩니다.

활용 예시

직접 사용해보세요

무료로 택배 API를 테스트하고 연동할 수 있습니다

무료로 시작하기 →