业务协同

业务协同面向渠道与合作方的 S2S 交易与履约对接,覆盖采购下单、订单查询等能力。 后续发货协同、对账等业务接口也将归入本分组。

模块概述

与「健康数据」「检测插件」等能力产品文档不同,本模块聚焦渠道采购与履约链路:合作方系统创建订单、查询状态,平台侧完成审核与发货后通过 Webhook 回传。

角色职责
渠道方调用开放接口创建 / 查询订单,配置 Webhook 接收发货等事件
晓葆平台校验商品、生成平台订单编码、审核履约,并向渠道推送状态变更

能力范围

  • 订单开放:采购下单、按 order_code 查询详情。 详见 订单 API
  • 发货协同(规划中):平台发货后通过 Webhook 推送物流与设备 SN 等信息。

鉴权方式

本分组下对外开放接口均为 S2S,使用 AppKey + 签名。完整算法见鉴权说明

Header类型说明
X-App-Idstring控制台「凭证管理」中的 App ID
X-TimestampintegerUnix 秒级时间戳,有效窗口 ±5 分钟
X-Signaturestring请求签名,见鉴权说明

接口清单

当前已开放(前缀 /open/v1/order):

方法路径说明
POST/open/v1/order/create创建采购订单
GET/open/v1/order/detail按 order_code 查询订单详情