CAPABILITIES
六项核心接口，覆盖下单全链路
统一 REST 风格、JSON 报文，30 分钟即可完成首次联调
POST /v1/quote
运费试算：输入收发城市与重量，返回权威报价与 quoteId
POST /v1/order/create
创建订单：凭 quoteId 下单，价格由服务端锁定
POST /v1/order/detail
订单查询：状态、费用明细、收发信息全量返回
POST /v1/order/track
轨迹查询：已取件 / 已上高铁 / 已送达全节点
POST /v1/order/cancel
取消订单：支持备注取消原因，自动校验归属
GET /v1/city/list
城市列表：获取全部开通城市编码，便于本地映射
ONBOARDING
五步完成接入，最快 3 个工作日上线
| 步骤 | 事项 | 耗时 |
|---|---|---|
| 1 | 提交接入申请（企业信息、业务场景、预估单量） | 10 分钟 |
| 2 | 商务确认合作方式与折扣档位，签署合作协议 | 1 个工作日 |
| 3 | 开通沙箱环境，发放 AppId / AppSecret | 即时 |
| 4 | 按文档联调：询价 → 下单 → 查询 → 回调 | 1-3 天 |
| 5 | 切换生产环境，正式启用，月结对账 | 即时 |
DOCUMENTATION
接口文档与鉴权规则
所有请求需携带四个鉴权头，签名不通过直接拒绝
| 请求头 | 说明 |
|---|---|
X-STZD-AppId | 开放平台分配的应用 ID |
X-STZD-Timestamp | 毫秒级时间戳，与服务端偏差超过 5 分钟拒绝 |
X-STZD-Nonce | 随机串，防重放 |
X-STZD-Sign | 签名，见下方算法 |
签名算法（HMAC-SHA256）
sign = HMAC_SHA256(
secret = AppSecret,
message = AppId + Timestamp + Nonce + 请求原始Body
).toUpperCase()
// 示例（Node.js）
const crypto = require('crypto')
const sign = crypto.createHmac('sha256', appSecret)
.update(appId + ts + nonce + rawBody)
.digest('hex').toUpperCase()
下单必须先询价
为保证价格权威与资金安全，平台采用「先询价、后下单」机制：
调用 /v1/quote 获取 quoteId 与报价（有效期 30 分钟），
再凭 quoteId 调用 /v1/order/create。
下单时服务端按报价单强制锁定金额，请求中传入的价格字段不生效，
从源头杜绝价格篡改风险。
API 渠道无需在下单前上传物品照片，改由骑手上门取件时现场拍照留证；
但必须在 goods.desc 中如实申报物品名称与性质，
寄件方对申报内容负责。
WHO IT'S FOR
这些场景，最适合接入
基因检测 / 医疗冷链
采样点样本快速回传实验室，时效决定报告周期
律所 / 司法鉴定
卷宗、合同、鉴定材料跨城当日送达，留痕可追溯
检测机构 / 半导体
样品、晶圆、精密器件专人直送，减少中转
电商 / ERP 系统
订单系统直接调用运力，省去人工填单
COMMERCIAL
合作与结算方式
| 项目 | 说明 |
|---|---|
| 接入费用 | 标准接口接入不额外收费，具体以合作协议为准 |
| 运费折扣 | 按上月实际运费自动升降档，用得越多折扣越低（详见阶梯折扣方案） |
| 结算方式 | 支持预存余额抵扣与月结，对公转账并可开具发票 |
| 服务保障 | 专属客服、优先派单、超时赔付，可约定准时率 SLA |
| 技术支持 | 提供沙箱环境、联调支持与接口文档 |
GET STARTED
申请接入，让我们了解你的场景
提交后 1 个工作日内，商务会与你联系确认方案与折扣档位
申请时请准备以下信息，便于我们快速评估：
• 企业全称与营业执照所在城市
• 业务场景与寄递物品类型（是否涉及冷链、生物样本、危险品）
• 主要收发城市与线路
• 预估日均 / 月均单量
涉及生物样本、医疗器械等特殊物品的，请先准备非危险品声明 / MSDS， 我们将据此确认承运方案与包装责任界定。