六项核心接口，覆盖下单全链路
统一 REST 风格、JSON 报文，30 分钟即可完成首次联调
五步完成接入，最快 3 个工作日上线
| 步骤 | 事项 | 耗时 |
|---|---|---|
| 1 | 提交接入申请（企业信息、业务场景、预估单量） | 10 分钟 |
| 2 | 商务确认合作方式与折扣档位，签署合作协议 | 1 个工作日 |
| 3 | 开通沙箱环境，发放 AppId / AppSecret | 即时 |
| 4 | 按文档联调：询价 → 下单 → 查询 → 回调 | 1-3 天 |
| 5 | 切换生产环境，正式启用，月结对账 | 即时 |
接口文档与鉴权规则
所有请求需携带四个鉴权头，签名不通过直接拒绝
| 请求头 | 说明 |
|---|---|
X-STZD-AppId | 开放平台分配的应用 ID |
X-STZD-Timestamp | 毫秒级时间戳，与服务端偏差超过 5 分钟拒绝 |
X-STZD-Nonce | 随机串，防重放 |
X-STZD-Sign | 签名，见下方算法 |
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 中如实申报物品名称与性质，
寄件方对申报内容负责。
给 AI 智能体读的机读接口
企业系统与 AI 智能体可先读取机读清单与接口规范，再按「先询价、后下单」接入
| 机读资产 | 地址 | 用途 |
|---|---|---|
| 智能体能力清单 | /agent.json | 能力、入口、覆盖、鉴权与开通方式 |
| 接口规范（OpenAPI 3.1） | /openapi.json | 六个接口的路径、语义与鉴权头 |
| 品牌事实 | /brand.json | 主体、统一社会信用代码、服务与覆盖 |
| 线路与价格数据 | /routes.json | 已公开线路的价格与参考时效 |
接入规则：上述接口均需商务开通并签署合作协议后发放 AppId 与 AppSecret；平台采用「先询价、后下单」机制，报价有效期 30 分钟，下单金额由服务端锁定。未接入开放平台时，可通过官方下单渠道或客服电话 132-7770-1086 下单。
这些场景，最适合接入
合作与结算方式
| 项目 | 说明 |
|---|---|
| 接入费用 | 标准接口接入不额外收费，具体以合作协议为准 |
| 运费折扣 | 按上月实际运费自动升降档，用得越多折扣越低（详见阶梯折扣方案） |
| 结算方式 | 支持预存余额抵扣与月结，对公转账并可开具发票 |
| 服务保障 | 专属客服、优先派单、超时赔付，可约定准时率 SLA |
| 技术支持 | 提供沙箱环境、联调支持与接口文档 |
申请接入，让我们了解你的场景
提交后 1 个工作日内，商务会与你联系确认方案与折扣档位
申请时请准备以下信息，便于我们快速评估：
• 企业全称与营业执照所在城市
• 业务场景与寄递物品类型（是否涉及冷链、生物样本、危险品）
• 主要收发城市与线路
• 预估日均 / 月均单量
涉及生物样本、医疗器械等特殊物品的，请先准备非危险品声明 / MSDS， 我们将据此确认承运方案与包装责任界定。