API面向电商品牌、电商平台和 3PL 的开发者
运费、附带报关单据的面单、物流追踪与 webhook、地址验证，全部以简洁的 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
您创建的每个货件都可追踪。随时查询其状态，或注册一个 webhook，让状态更新随包裹移动按顺序推送给您。
购买面单前先检查地址。在结账或仓库环节发现拼写错误，比之后包裹被退回或被承运商收取更正费用要省钱得多。
1200 main st
philadelphia pa
1200 Main St
Philadelphia, PA 19103
api 参考
用通俗语言列出 API 涵盖的内容。准确的路径、字段和响应请查看完整的 API 参考文档。
| 领域 | 您发送 | 您收到 | 示例 |
|---|---|---|---|
| 运费 | 发货地、目的地，以及包裹尺寸和重量 | 已连接承运商的运费，按从便宜到贵排序 | POST /rates |
| 面单 | 您选中的运费 | 可打印的面单，跨境包裹另附报关单据 | ex.labels.create(...) |
| 物流追踪 | 您创建的货件 | 其当前状态和历史记录 | 见参考文档 |
| Webhook | 您这边的一个 URL | 每个货件移动时推送到该 URL 的状态更新 | 见参考文档 |
| 地址验证 | 一个地址 | 是否可投递，并尽可能附上更正后的地址 | 见参考文档 |
webhook
无需逐一轮询各承运商，只要给 ExperShip 一个 URL。货件移动时，状态更新会按顺序推送到该 URL，让您的订单记录、仪表板和买家邮件始终保持最新。
您服务器上一个接收 JSON 的 URL。
每个货件的状态变化按发生顺序到达。
把状态写入订单，触发买家邮件，或为团队标记问题。
// 您的服务器：接收状态更新并保存 app.post('/shipping-updates', async (req, res) => { const update = req.body await saveShipmentStatus(update) // 您的代码 res.sendStatus(200) })
指南
关于物流 API、承运商和海关的实用指南，写给构建电商系统的人。
