자주 묻는 질문
WhereParcel 택배조회API에 대해 궁금한 점을 모두 모았습니다. 찾는 답이 없다면 커뮤니티 게시판에 질문을 남겨주세요.
일반
WhereParcel이란 무엇인가요?
WhereParcel은 전 세계 500개 이상의 택배사를 하나의 REST API로 통합 조회할 수 있는 택배조회API입니다. 각 택배사별로 따로 연동할 필요 없이 하나의 API로 정규화된 JSON 응답을 받을 수 있습니다.
WhereParcel은 몇 개의 택배사를 지원하나요?
WhereParcel은 16개국 500개 이상의 택배사를 지원합니다. CJ대한통운, 한진택배, 롯데택배, USPS, UPS, FedEx, DHL, 야마토운수, 사가와급편, 로열메일 등 주요 택배사를 포함합니다.
어떤 나라를 지원하나요?
한국, 미국, 일본, 독일, 영국, 캐나다, 호주, 중국, 인도, 싱가포르, 뉴질랜드, 아일랜드, 남아프리카공화국, 홍콩, 필리핀의 택배사와 국제 배송 택배사를 지원합니다.
이커머스(쇼핑몰)에 적합한가요?
물론입니다. WhereParcel은 이커머스, 물류, 배송 플랫폼을 위해 설계되었습니다. 대량 추적(요청당 최대 500건), 주문 상태 페이지용 실시간 웹훅, 멀티 택배사 지원 등 온라인 쇼핑몰에 필요한 모든 기능을 제공합니다.
시작하기
어떻게 시작하나요?
whereparcel.com/signup에서 무료 계정을 생성하세요. 대시보드에서 API 키를 발급받아 5분 안에 첫 택배 조회를 할 수 있습니다. 신용카드 등록이 필요 없습니다.
연동은 어떻게 하나요?
API 키를 발급받은 후, 택배사 코드와 운송장 번호로 /v2/track에 POST 요청을 보내면 됩니다. cURL, Node.js, Python, PHP, Go 코드 예제를 제공합니다. whereparcel.com/docs에서 빠른 시작 가이드를 확인하세요.
택배사 코드 형식은 어떻게 되나요?
택배사 코드는 {국가}.{택배사} 형식입니다. 예: us.usps, kr.cjlogistics, jp.yamato, de.dhl. GET /v2/carriers로 전체 택배사 코드 목록을 확인할 수 있습니다.
가입 전에 API를 테스트할 수 있나요?
네! whereparcel.com/playground에서 샘플 데이터로 추적 요청을 테스트할 수 있습니다. 계정 없이도 바로 체험 가능합니다.
API 및 기술
API 응답 시간은 얼마나 되나요?
캐시된 결과는 500ms 이내, 실시간 택배사 조회는 2-3초 이내에 응답합니다. 미국, 유럽, 아시아 5개 리전에 배포되어 위치에 관계없이 빠른 응답을 제공합니다.
한 번의 요청으로 여러 택배를 조회할 수 있나요?
네. 하나의 POST /v2/track 요청에 최대 500건의 택배를 포함할 수 있으며, 각각 다른 택배사도 가능합니다. 모든 결과가 하나의 응답으로 반환됩니다.
어떤 인증 방식을 사용하나요?
모든 API 요청에 Authorization: Bearer YOUR_API_KEY:YOUR_SECRET_KEY 헤더가 필요합니다. 가입 후 대시보드에서 키를 발급받을 수 있으며, TLS 암호화 연결을 통해 전송됩니다.
택배사 자동 감지를 지원하나요?
현재는 각 조회 요청에 택배사 코드를 지정해야 합니다. 운송장 번호 형식을 통한 자동 감지 기능은 향후 업데이트에서 제공할 예정입니다.
OpenAPI 스펙이 제공되나요?
네. 영어(whereparcel.com/openapi.en.yaml), 한국어(whereparcel.com/openapi.ko.yaml), 일본어(whereparcel.com/openapi.ja.yaml) 3개 언어로 OpenAPI 3.0 스펙을 제공합니다.
웹훅 및 알림
웹훅은 어떻게 작동하나요?
웹훅 엔드포인트 URL을 등록한 후 추적할 택배를 구독하세요. 택배 상태가 변경되면 WhereParcel이 해당 URL로 POST 요청을 보내 업데이트된 추적 데이터를 전달합니다. 폴링 없이 즉시 알림을 받을 수 있습니다.
반복 웹훅과 일회성 웹훅의 차이는 무엇인가요?
recurring: true로 설정하면 배송 완료까지 모든 상태 변경 시 알림을 보냅니다. recurring: false로 설정하면 한 번만 조회하고 결과를 전달합니다.
웹훅 전달 실패 시 재시도하나요?
네. 엔드포인트가 일시적으로 사용 불가한 경우, WhereParcel은 지수 백오프(exponential backoff) 방식으로 자동 재시도하여 중요한 상태 업데이트를 놓치지 않도록 합니다.
가격 및 결제
무료 플랜이 있나요?
네. WhereParcel은 월 1,000건의 무료 조회를 제공합니다. 신용카드 등록 없이 바로 시작할 수 있으며, 500개 이상의 모든 택배사 이용이 가능합니다. 사용량이 늘어나면 업그레이드할 수 있습니다.
유료 플랜은 어떤 것이 있나요?
Starter($49/월)는 10,000건과 웹훅을 포함합니다. Pro($99/월)는 30,000건과 우선 지원을 포함합니다. Business($199/월)는 300,000건, 전담 지원, 99.95% SLA를 포함합니다.
요청 제한(Rate Limit)이 있나요?
네, 요청 제한은 플랜에 따라 다릅니다. 무료 플랜은 일 100건, 월 1,000건입니다. 유료 플랜은 더 높은 제한을 제공합니다. 가격 페이지에서 자세한 내용을 확인하세요.
숨겨진 비용이 있나요?
없습니다. WhereParcel은 투명한 건당 과금 방식입니다. 선택한 플랜 비용만 지불하면 됩니다. 설정 비용, 숨겨진 수수료, 장기 계약이 없습니다.