whereparcel

궁금한 게 있으세요? 편하게 물어보세요. WhereParcel을 만든 개발자가 직접 읽고 답장드립니다.

빠른 시작

5분 안에 WhereParcel API 시작하기

몇 분 안에 WhereParcel API를 시작하세요.

1. API 키 받기

가입 후 대시보드에서 API 키를 받으세요. 언제든 취소할 수 있으며, 취소해도 결제 기간이 끝날 때까지 이용할 수 있습니다.

2. 첫 번째 요청 보내기

curl -X POST https://api.whereparcel.com/v2/track \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "trackingItems": [
      {
        "carrier": "kr.post",
        "trackingNumber": "1234567890123"
      }
    ]
  }'

3. 응답 파싱

{
  "success": true,
  "data": [
    {
      "carrier": "kr.post",
      "trackingNumber": "1234567890123",
      "status": "success",
      "data": {
        "deliveryStatus": "delivered",
        "events": [
          {
            "timestamp": "2026-01-15T05:30:00.000Z",
            "status": "delivered",
            "location": "서울특별시 강남구",
            "description": "배달완료",
            "rawStatus": "배달완료",
            "rawDescription": "배달완료"
          }
        ],
        "lastUpdated": "2026-01-15T06:00:00.000Z"
      },
      "billable": true,
      "cached": false
    }
  ],
  "summary": { "total": 1, "success": 1, "failed": 0, "usageIncremented": 1 }
}

data 는 조회한 송장마다 결과 하나씩 들어 있는 배열입니다. 먼저 항목의 status(success 또는 error)를 보고, 그다음 data.deliveryStatus 를 읽으세요. 값은 항상 9개 중 하나입니다: pending, in_transit, out_for_delivery, delivered, failed, returned, cancelled, lost, unknown. 택배사 원문은 rawStatus · rawDescription 에 그대로 남습니다. 시각은 UTC 입니다. 캐시에서 온 결과는 billable: false 입니다.

다음 단계