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
}
}
다음 단계
첫 번째 요청을 성공적으로 보냈다면, 다음 주제들을 살펴보세요:
- 인증 가이드 - API 키 보안 모범 사례 알아보기
- Webhook 설정 - 배송 알림 자동으로 받기
- 택배사 목록 - 지원하는 39개 이상의 택배사 확인하기
즐거운 배송 추적 되세요!
원하는 택배사가 없으신가요? 요청해 주시면 빠르게 연동해 드립니다.
택배사 요청하기 →더 알아보기
궁금한 게 있으세요? 편하게 물어보세요. Discord에 들어오시면 WhereParcel을 만든 개발자가 직접 읽고 답장드립니다. 봇도 없고 티켓도 없어요. 그냥 편하게 대화하세요.
Discord 참여하기 → Slack 참여하기 →