Image description
## 快速开始

ShipSaving Legacy API（V1）提供了一套成熟、稳定的物流接口解决方案，可将发货能力直接集成到你的系统或应用中。通过一次对接，你即可在同一平台内完成多家承运商的物流操作，包括获取折扣运费、创建面单、查询物流状态、预约取件等。

Legacy API V1 已长期稳定运行，被大量商家和系统广泛使用，适合对稳定性要求较高、已完成集成或不计划短期升级的业务场景。

### 主要功能

通过Legacy API（V1），你可以实现以下核心功能：

- 创建和管理订单
- 获取运费报价
- 购买与作废物流面单
- 生成 SCAN Form
- 获取账户与承运商信息


### API 接入流程说明

根据你的业务系统结构和使用习惯，Legacy API（V1）支持以下几种常见接入方式：

#### 👍 接入方式一

先获取运费，再购买面单。适用于需要在下单前进行运费展示或比价的业务场景。

1. 获取运费（Get Rate）
2. 购买面单（Buy Label）


#### 接入方式二

直接购买面单。适用于业务流程简单、运费规则固定的场景。

1. 直接购买面单（Buy Label）


> 限制说明
该方式仅适用于账户中只绑定单一类型承运商账号的情况，例如：仅有一个UPS账号；仅有一个FedEx账号；仅有一个USPS账号。


#### 接入方式三

完整订单流程。适用于希望在 ShipSaving 系统中完整管理订单和物流流程的场景。

1. 创建订单（Create Orders）
2. 获取运费（Get Rate）
3. 购买面单（Buy Label）


> 说明
创建订单并非强制要求。如果你已经在自己的系统中管理订单数据，可以仅使用运费查询和面单购买相关接口。


### Postman 合集

我们提供了开箱即用的 Postman 合集，帮助你快速探索和测试 API。

通过 Postman 快速上手
1. 下载并解压下方的 ZIP 文件
2. 打开 Postman → 点击左上角 **Import**
3. 将解压后的 3 个 JSON 文件拖入，或点击 **Choose Files** 选择
4. 在右上角环境下拉菜单中选择 **ShipSaving V1 — SANDBOX** 或 **PROD**
5. 点击环境下拉旁的 **眼睛图标** → 填入你的 `apiToken`
6. 即可开始发送请求


**下载：** [ShipSaving Legacy API V1 Postman 合集 (ZIP)](/assets/shipsaving_legacy_api_v1_postman.6e1aec97ebb50cdf33c1cde06dcedac7d25fa9841f3072505a034cc9fb461546.843036ec.zip)

ZIP 包含 API 合集及两个环境文件（Sandbox 和 Production）。