适用版本
开放平台仅适用于大客户版本。
1. 联系客户经理开通账号
接入开放平台前,先联系所属机构的客户经理,由客户经理发起开通。需提供要访问的连锁(或单店)信息,以及机构负责人的姓名、手机号和邮箱。
开通完成后,appId 和 appSecret 会发送至预留邮箱。应用调用授权接口获取 AccessToken 后,即可访问授权范围内的接口和数据。如需修改应用密钥或权限,请联系客户经理。
2. 获取 AccessToken
调用 POST /api/v2/auth/token,提交 grantType=client_credentials、appId、appSecret;连锁应用还需指定子店 clinicId。
3. 调用 API
在顶部选择实际使用的产品线,从左侧接口文档选择接口,确认最终请求路径和 GET Query 参数;再用当前秒级时间戳计算签名,携带 appId、ts、sign、authorization 请求头调用。
接口和事件只能在已授权门店范围内使用。
4. 接收业务事件(按需)
第三方如需及时感知创建、更新、退费等业务变化,可配置回调 URL 并订阅事件。接收方应实现验签、持久化、幂等和异常处理。