whereparcel

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

튜토리얼 8 분 소요

WhereParcel API 시작하기

WhereParcel 택배조회API를 10분 안에 애플리케이션에 연동하는 방법을 알아보세요. 39개 이상의 택배사를 하나의 API로 조회.

WhereParcel Team

WhereParcel은 전 세계 39개 이상의 택배사에서 소포를 추적할 수 있는 통합 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.cj", "trackingNumber": "1234567890" }]
  }'

3단계: 응답 파싱하기

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

{
  "success": true,
  "data": [
    {
      "carrier": "kr.cj",
      "trackingNumber": "1234567890",
      "status": "success",
      "data": {
        "deliveryStatus": "in_transit",
        "estimatedDelivery": "2026-02-05",
        "events": [
          {
            "timestamp": "2026-02-01T10:30:00Z",
            "status": "in_transit",
            "location": "Seoul Sorting Center",
            "description": "Package picked up from sender"
          }
        ],
        "lastUpdated": "2026-02-01T10:30:00Z"
      },
      "billable": true,
      "cached": false
    }
  ],
  "summary": {
    "total": 1,
    "success": 1,
    "failed": 0,
    "usageIncremented": 1
  }
}

다음 단계

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

즐거운 배송 추적 되세요!

원하는 택배사가 없으신가요? 요청해 주시면 빠르게 연동해 드립니다.

택배사 요청하기 →

궁금한 게 있으세요? 편하게 물어보세요. Discord에 들어오시면 WhereParcel을 만든 개발자가 직접 읽고 답장드립니다. 봇도 없고 티켓도 없어요. 그냥 편하게 대화하세요.

Discord 참여하기 → Slack 참여하기 →

태그: #api #quickstart #integration