Image description
## 欢迎使用 ShipSaving API

无论你是正在成长中的电商品牌、物流合作伙伴，还是正在搭建发货系统的开发团队，
ShipSaving API都可以为你提供灵活、稳定的接口能力，帮助你更高效地完成物流相关操作。

通过ShipSaving API，你可以统一对接多家主流承运商，包括USPS、UPS、FedEx、DHL Express等，实现创建并购买物流面单，获取并对比实时运费，查询和跟踪物流状态，进行地址校验与规范化，以及更多与发货相关的核心功能。所有能力均通过统一的API接口体系提供，简化系统集成流程，降低对接成本。

### 两个 API 版本，一个统一的平台能力

为了满足不同用户和系统的对接需求，ShipSaving 目前同时提供两个 API 版本：

Legacy API（V1）
- 已稳定运行多年
- 被大量商家和系统广泛使用
- 覆盖核心的物流与发货功能
- 适合已有系统持续稳定运行


New API（v2）
- 基于全新架构重新设计
- 更高的可扩展性和模块化能力
- 接口结构更清晰，数据更规范
- 提供更好的开发体验，并持续迭代新功能


我们建议新的系统集成优先使用New API V2，以便获得最新能力和后续功能更新。
同时，Legacy API V1仍会继续维护，确保现有用户和系统的稳定使用。

### Core Capabilities

ShipSaving API提供了一套完整的物流基础能力，可按需单独使用，也可组合使用，构建符合你业务需求的发货流程。

#### 📦 创建物流面单

支持快速创建并购买USPS、UPS、FedEx、DHL Express等承运商的物流面单，
覆盖美国本土及国际发货场景，并享受平台提供的折扣价格。

#### 💰 获取最优运费

一次请求即可获取多家承运商的实时运费报价，帮助你快速对比不同服务方案，选择性价比最高的发货方式。（支持在未提供完整包裹信息的情况下进行快速运费预览。）

#### 🚚 物流跟踪

随时查询包裹的最新物流状态，也可配置自动化更新机制，及时向你的系统或客户同步物流进展。（Webhook功能即将上线）

#### 📍 地址校验

在发货前对美国国内地址进行校验和规范化处理，有效减少因地址错误导致的退件、延误或额外费用。

## 开发环境说明

ShipSaving API提供测试环境（Sandbox）和正式环境（Production），方便你在不同阶段进行开发、测试和上线。

- 不同环境使用独立的API Key
- 使用测试环境Key发起的请求不会产生真实订单或费用
- 建议在测试环境完成调试后，再切换至正式环境


## 需要帮助？

我们的团队将在你接入API的整个过程中提供支持，无论是首次对接、问题排查，还是高级功能的使用，都可以随时联系我们。

支持方式包括：

- 客户经理支持：直接联系你的专属客户经理或支持群
- it@shipsaving.com