API이커머스 브랜드, 마켓플레이스, 3PL 개발자를 위해
요금, 통관 서류가 포함된 라벨, 배송 추적과 웹훅, 주소 검증을 간결한 REST 엔드포인트로 제공합니다. UPS, FedEx, USPS, DHL 배송을 스토어, 마켓플레이스 도구, 창고 시스템에 통합하세요.
// 예시 요청: 요금을 비교한 뒤 라벨 구매 const rates = await ex.rates.create({ from: { country: 'ES', city: 'Barcelona' }, to: { country: 'US', city: 'Atlanta', state: 'GA' }, parcel: { weight_oz: 8, length_in: 10, width_in: 8, height_in: 3 }, }) // 가장 저렴한 요금 구매, 통관 서류 포함 const label = await ex.labels.create({ rate: rates[0].id })
연동 구조
코드는 API 하나와만 통신합니다. ExperShip이 각 택배사를 처리하고, 요금과 라벨을 돌려주며, 배송이 진행될 때마다 추적 업데이트를 보내 드립니다.
만들 수 있는 것
ExperShip 웹 앱과 같은 기능을 API로 제공합니다. 하나만 쓰거나, 주문부터 문 앞까지 전체 흐름을 연결하세요.
출발지, 도착지, 소포 정보를 보내세요. 계정에 연결된 택배사의 실시간 요금이 저렴한 순으로 돌아오므로 코드나 결제 화면에서 알맞은 서비스를 고를 수 있습니다.
| # | 택배사 | 서비스 | 비고 |
|---|---|---|---|
| 0 | FedEx | Home Delivery | 기한 내 최저가 |
| 1 | USPS | Ground Advantage | 비교됨 |
| 2 | UPS | Ground | 비교됨 |
| 3 | USPS | Priority Mail | 비교됨 |
선택한 요금을 출력 가능한 라벨로 바꾸세요. 미국으로 들어가는 소포는 같은 단계에서 통관 서류가 함께 돌아오므로 손으로 채울 것이 없습니다.
// 요금은 저렴한 순으로 반환됨; rates[0] 구매 const label = await ex.labels.create({ rate: rates[0].id }) // 해외 배송 소포: 라벨 + 세관 신고서 // UPS Worldwide Expedited · Barcelona, 스페인 → Atlanta, GA
생성한 모든 배송은 추적할 수 있습니다. 언제든 상태를 조회하거나, 웹훅을 등록해 소포가 이동할 때마다 상태 업데이트를 순서대로 받으세요.
라벨을 구매하기 전에 주소를 확인하세요. 결제 단계나 창고에서 오타를 잡는 편이 반송된 소포나 나중의 택배사 주소 정정보다 훨씬 저렴합니다.
1200 main st
philadelphia pa
1200 Main St
Philadelphia, PA 19103
api 레퍼런스
API가 다루는 범위를 쉬운 말로 정리한 지도입니다. 정확한 경로, 필드, 응답은 전체 API 레퍼런스에서 확인하세요.
| 영역 | 보내는 것 | 받는 것 | 예시 |
|---|---|---|---|
| 요금 | 출발지, 도착지, 소포 크기와 무게 | 연결된 택배사의 요금, 저렴한 순 | POST /rates |
| 라벨 | 선택한 요금 | 출력 가능한 라벨, 해외 배송 소포는 통관 서류 포함 | ex.labels.create(...) |
| 배송 추적 | 생성한 배송 | 현재 상태와 이력 | 레퍼런스 참고 |
| 웹훅 | 내 쪽의 URL | 각 배송이 진행될 때마다 그 URL로 전달되는 상태 업데이트 | 레퍼런스 참고 |
| 주소 검증 | 주소 | 배송 가능 여부, 가능하면 수정된 주소 포함 | 레퍼런스 참고 |
웹훅
택배사마다 조회할 필요 없이 ExperShip에 URL 하나만 알려 주세요. 배송이 진행되면 상태 업데이트가 그 URL로 순서대로 전달되어 주문 기록, 대시보드, 구매자 메일이 늘 최신 상태로 유지됩니다.
JSON을 받는 내 서버의 URL.
각 배송의 상태 변경이 발생한 순서대로 도착합니다.
상태를 주문에 기록하고, 구매자 메일을 보내거나, 팀에 문제를 알리세요.
// 내 서버: 상태 업데이트를 받아 저장 app.post('/shipping-updates', async (req, res) => { const update = req.body await saveShipmentStatus(update) // 내 코드 res.sendStatus(200) })
가이드
배송 API, 택배사, 통관에 관한 실용 가이드로, 이커머스 시스템을 만드는 분들을 위해 썼습니다.
