본문으로 건너뛰기

V1 API

위험

본 항목의 v1 API 들은 Deprecated 된 API 입니다. 새롭게 개발하시는 경우 v2 API 사용을 권장 드립니다. v1 API의 경우 2024-12-31까지 제공될 예정이며, 종료 30일 전 공지 예정 입니다.

링크형​

정보

V2는 신규 Tracking Link 문서를 참고해주세요.

별도의 개발 없이 여러분의 사이트에 링크를 추가하여 배송조회 기능을 추가하실 수 있습니다.

https://tracker.delivery/#/:carrier_id/:track_id

Example

<a href="https://tracker.delivery/#/kr.cjlogistics/1234567890" target="_blank">Link</a>

API형​

택배사 목록 조회 API​

정보

V2는 신규 Tracking API 문서를 참고해주세요.

GET https://apis.tracker.delivery/carriers

Example response

[
  {
    "id": "kr.cjlogistics",
    "name": "CJ대한통운",
    "tel": "+8215881255"
  },
  {
    "id": "kr.coupangls",
    "name": "쿠팡 로지스틱스 서비스"
  },
  {
    "id": "kr.cupost",
    "name": "CU 편의점택배",
    "tel": "+8215771287"
  },
  {
    "id": "kr.chunilps",
    "name": "천일택배",
    "tel": "+8218776606"
  },
  {
    "id": "kr.cvsnet",
    "name": "GS Postbox",
    "tel": "+8215771287"
  },
  ...
]

배송 조회 API​

정보

V2는 신규 Tracking API 문서를 참고해주세요.

GET https://apis.tracker.delivery/carriers/:carrier_id/tracks/:track_id

Example response

{
  "carrier": {
    "id": "kr.cjlogistics",
    "name": "CJ대한통운",
    "tel": "+8215881255"
  },
  "from": {
    "name": null,
    "time": "2023-12-06T14:58:57+09:00"
  },
  "to": {
    "name": null,
    "time": "2024-04-25T17:19:20+09:00"
  },
  "progresses": [
    {
      "time": "2023-12-06T14:58:57+09:00",
      "status": {
        "id": "in_transit",
        "text": "간선상차"
      },
      "location": {
        "name": "용산1"
      },
      "description": "물류터미널로 상품이 이동중입니다."
    },
    {
      "time": "2024-04-24T15:26:13+09:00",
      "status": {
        "id": "at_pickup",
        "text": "집화처리"
      },
      "location": {
        "name": "경기고양신삼송"
      },
      "description": "보내시는 고객님으로부터 상품을 인수받았습니다"
    },
    {
      "time": "2024-04-24T17:15:37+09:00",
      "status": {
        "id": "in_transit",
        "text": "SM입고"
      },
      "location": {
        "name": "덕양AMP"
      },
      "description": "배송지역으로 상품이 이동중입니다."
    },
    {
      "time": "2024-04-25T06:28:42+09:00",
      "status": {
        "id": "in_transit",
        "text": "간선상차"
      },
      "location": {
        "name": "대전HUB"
      },
      "description": "배송지역으로 상품이 이동중입니다."
    },
    {
      "time": "2024-04-25T09:17:56+09:00",
      "status": {
        "id": "out_for_delivery",
        "text": "배송출발"
      },
      "location": {
        "name": "충북보은"
      },
      "description": "고객님의 상품을 배송할 예정입니다.(17~19시)(배송담당:이래건 010-9473-1038)"
    },
    {
      "time": "2024-04-25T17:19:20+09:00",
      "status": {
        "id": "delivered",
        "text": "배송완료"
      },
      "location": {
        "name": "충북보은"
      },
      "description": "고객님의 상품이 배송완료 되었습니다.(담당사원:이래건 010-9473-1038)"
    }
  ],
  "state": {
    "id": "delivered",
    "text": "배송완료"
  }
}

인증​

Access Token 사용하기​

아래와 같이 Authorization 헤더를 주입하여 Access Token 을 전달하여 사용하여야 합니다.

GET https://apis.tracker.delivery/carriers/:carrier_id/tracks/:track_id
Authorization: TRACKQL-API-KEY [YOUR_CLIENT_ID]:[YOUR_CLIENT_SECRET]

Access Token 생성 방법은 Authentication 문서를 참고해주시기 바랍니다.

인증 하지 않고 사용하기​

위험

Access Token 없이 사용하는 것은 권장하지 않습니다. 테스트 목적으로만 사용하시기 바랍니다.

Deprecated 된 V1 API 의 경우 하위호환을 위해 인증 헤더를 삽입하지 않아도 사용 가능합니다.

이 경우 IP Address 등을 기반으로 Rate Limit 이 걸리게 됩니다.

인증 헤더가 없는 경우 적용되는 기본 Rate Limit 할당량은 서서히 감소될 예정이며, 인증 헤더를 추가하여 사용하시기 바랍니다.