TMS 物流系统 API 文档
欢迎使用 TMS 物流系统 API 文档。
快速开始
- 获取 API 授权信息（apiKey、apiSecret、apiUserCode）
- 按照 接口鉴权 文档生成签名
- 调用相应接口
接口列表
运单服务
| 接口 | 方法 | 路径 | 说明 |
|---|---|---|---|
| 询价 | POST | /label/rates | 查询客户可用报价列表 |
| 下单 | POST | /label/create | 同步创建 TMS 运单并下单 |
| 批量下单 | POST | /label/sync-batch-create | 异步批量下单，结果通过回调通知 |
| 取消运单 | POST | /label/void | 按跟踪号取消运单 |
| 运单详情 | POST | /label/detail | 按跟踪号/卖家单号/TMS 单号查询 |
| 地址校验 | POST | /label/verifyAddress | 调用承运商能力校验并标准化地址 |
轨迹订阅
| 接口 | 方法 | 路径 | 说明 |
|---|---|---|---|
| 订阅轨迹 | POST | /openapi/tracking-subscriptions | 单条订阅 |
| 批量订阅 | POST | /openapi/tracking-subscriptions/batch | 批量订阅 |
| 查询订阅 | GET | /openapi/tracking-subscriptions | 查询订阅详情 |
| 轨迹回调说明 | POST | 订阅时传入的 callbackUrl | 异步回调通知格式与重试规则 |
| 取消订阅 | POST | /openapi/tracking-subscriptions/:id/cancel | 取消订阅 |
通用说明
认证方式
所有接口都需要在请求头中携带认证信息：
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| Apikey | String | 是 | API Key |
| Timestamp | String | 是 | 秒级时间戳 |
| Apisign | String | 是 | 签名值（MD5加密） |
响应格式
成功响应：
{
"code": 200,
"data": {},
"message": "success"
}
错误响应：
{
"code": 400,
"data": null,
"message": "错误原因"
}