빠른 시작
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 입니다.
다음 단계
- API 플레이그라운드 — 코드 없이 브라우저에서 바로 API 테스트
- 인증 - API 인증에 대해 알아보기
- API 레퍼런스 - 모든 엔드포인트 탐색
- 택배사 - 지원 택배사 보기