第三方集成
面向已开通对应厂商对接能力的合作应用,提供身份解析等 S2S 适配接口。 厂商侧凭证由平台侧配置与保管,合作方仅使用开放平台 App 凭证调用。
模块概述
与「健康数据」「业务协同」等通用能力不同,本分组接口按厂商 / 合作项目开通,未开通的应用调用将返回业务错误。
文档仅描述开放平台侧请求 / 响应契约。厂商侧密钥、加解密材料、内部配置项不在公开文档中提供;接入前请联系商务 / 实施完成应用级开通。
适用范围
| 集成 | 典型场景 | 文档 |
|---|---|---|
| 杉泰健康小屋 | 合作方持有杉泰下发的用户 sign,需解析为平台可用的用户档案 | 杉泰健康小屋集成 |
鉴权方式
对外开放接口为 S2S,使用 AppKey + 签名。完整算法见鉴权说明。
| Header | 类型 | 说明 |
|---|---|---|
X-App-Id | string | 控制台「凭证管理」中的 App ID |
X-Timestamp | integer | Unix 秒级时间戳,有效窗口 ±5 分钟 |
X-Signature | string | 请求签名,见鉴权说明 |
X-Request-ID | string | 可选,链路追踪 ID |
接口清单
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /open/v1/integrations/shantai/resolve-user | 解析杉泰用户 sign,返回用户档案 |