WhereParcel API 시작하기

WhereParcel은 전 세계 500개 이상의 택배사에서 소포를 추적할 수 있는 통합 API를 제공합니다. 이커머스 플랫폼, 물류 대시보드, 고객 알림 시스템 등 어떤 서비스를 구축하든, WhereParcel API를 통해 실시간 배송 추적 데이터를 간편하게 받아볼 수 있습니다.

사전 준비

시작하기 전에 다음 사항을 확인하세요:

1단계: API 키 발급받기

가입 후 대시보드로 이동하여 새 API 키를 생성하세요. API 키는 다음과 같은 형식입니다:

wp_live_a1b2c3d4e5f6g7h8i9j0

이 키는 안전하게 보관하고, 클라이언트 측 코드에 절대 노출하지 마세요.

2단계: 첫 번째 요청 보내기

API를 사용하여 소포를 추적하는 방법은 다음과 같습니다:

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

3단계: 응답 파싱하기

API는 택배사에 관계없이 표준화된 추적 응답을 반환합니다:

{
  "success": true,
  "data": {
    "carrier": "kr.cjlogistics",
    "trackingNumber": "1234567890",
    "status": "in_transit",
    "estimatedDelivery": "2026-02-05",
    "events": [
      {
        "timestamp": "2026-02-01T10:30:00Z",
        "status": "picked_up",
        "location": "Seoul Sorting Center",
        "description": "Package picked up from sender"
      }
    ]
  }
}

다음 단계

첫 번째 요청을 성공적으로 보냈다면, 다음 주제들을 살펴보세요:

즐거운 배송 추적 되세요!