业务协同
业务协同面向渠道与合作方的 S2S 交易与履约对接,覆盖采购下单、订单查询等能力。 后续发货协同、对账等业务接口也将归入本分组。
模块概述
与「健康数据」「检测插件」等能力产品文档不同,本模块聚焦渠道采购与履约链路:合作方系统创建订单、查询状态,平台侧完成审核与发货后通过 Webhook 回传。
| 角色 | 职责 |
|---|---|
| 渠道方 | 调用开放接口创建 / 查询订单,配置 Webhook 接收发货等事件 |
| 晓葆平台 | 校验商品、生成平台订单编码、审核履约,并向渠道推送状态变更 |
能力范围
- 订单开放:采购下单、按
order_code查询详情。 详见 订单 API。 - 发货协同(规划中):平台发货后通过 Webhook 推送物流与设备 SN 等信息。
鉴权方式
本分组下对外开放接口均为 S2S,使用 AppKey + 签名。完整算法见鉴权说明。
| Header | 类型 | 说明 |
|---|---|---|
X-App-Id | string | 控制台「凭证管理」中的 App ID |
X-Timestamp | integer | Unix 秒级时间戳,有效窗口 ±5 分钟 |
X-Signature | string | 请求签名,见鉴权说明 |
接口清单
当前已开放(前缀 /open/v1/order):
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /open/v1/order/create | 创建采购订单 |
| GET | /open/v1/order/detail | 按 order_code 查询订单详情 |