******医院

******医院接入粤健通的接口程序项目的市场调研公示

******医院接入粤健通的接口程序项目，现面向社会公开征集供应商参与市场调研，为后续招标及实施提供参考。具体事项如下：

******医院接入粤健通的接口程序项目

2、主要内容:

主要技术参数及要求

1. 对接内容

1.1. 工作目标与任务

******居民提供如预约挂号、健康档案查询、家庭医生签约、免疫接种、智能导诊、移动支付、随访等各类基于电子健康码的医疗健康互联网服务。

******医院与省卫生健康委健康公共服务小程序“粤健通”的单点对接。

1.2. 对接前置条件

1.2.1. 业务系统接入注册

由项目组完成相关配置后，分配业务系统应用标识(appCode)和敏感信息加密秘钥(appKey)等相关信息。

1.3. 单点登录

1.3.1. 跳转链接

1.3.1.1. 业务场景

用户在“粤健通”小程序内点击业务系统链接并完成刷脸登录后，跳转到业务系统相关页面时，业务系统通过用户认证相关信息实现单点登录功能。

1.3.1.2. 业务流程

业务系统与“粤健通”小程序通过电子完成单点登录认证的流程如下：

1. 用户点击业务系统链接后，由“粤健通”小程序完成刷脸认证登录流程；

2. 刷脸认证后，“粤健通”小程序调用服务端，获取此次会话的code(5分钟有效)；

3. “粤健通”小程序在业务系统链接url后拼接上code参数，例如业务系统链接为“******”,则拼接code后的链接为“******?code=afadsgfaar”；

4. 业务系统前端从请求url中获取code值并传入业务系统服务端，业务系统服务端调用code换取用户认证信息接口，获取用户认证类型和认证代码；

5. 业务系统服务端解密用户认证信息后，完成系统内部的账号认证流程。

2. 接口定义

2.1. 协议

与“粤健通”小程序系统通信协议，使用HTTPS协议。

2.2. 请求响应报文格式

接口正常响应的报文，规定以标准JSON格式字符串返回。其中，

1． 字符串编码格式统一使用UTF-8；

2． 按照API网关接入规范要求，请求“粤健通”接口的请求头，均需增加网关相关请求参数，网关接入参数如下表所示：

2.3. 错误码定义

2.4. 接口文档

2.4.1. code换取用户认证信息

2.4.1.1. 描述

业务系统通过此接口，以code换取病人健康码信息后，完成系统内的账号认证流程。

2.4.1.2. URL

测试环境：******/ebus/health/facade?command=01

正式环境：******/ebus/health/facade?command=01

2.4.1.3. 协议类型

GET协议

2.4.1.4. 请求参数

2.4.1.5. 响应报文内容

data

2.4.1.6. 报文示例

响应报文：

{

　　"errcode": 0,

　　"errmsg": "SUCCESS",

　　"data": {

　　　　"certificateNo": "xxxxx",

　　　　"certificateType": "xxxxx

　　　　"healthCardNo": "xxxx",

　　　　"phone": "xxxx",

　　　　"gender": xxx,

　　　　"name": "xxx",

"nation": "xxx",

"userId": "xxx",

"channel": "xxx",

　　}

}

2.4.2. 获取用户档案信息

2.4.2.1. 描述

业务系统通过此接口，以用户ID获取用户新冠预约档案信息。

2.4.2.2. URL

测试环境：******/ebus/health/facade?command=27

正式环境：******/ebus/health/facade?command=27

2.4.2.3. 协议类型

POST协议

2.4.2.4. 请求参数（body）

2.4.2.5. 响应报文内容

data

2.4.2.6. 报文示例

响应报文：

{

　　"errcode": 0,

　　"errmsg": "SUCCESS",

　　"data": [{

　　　　"certificateNo": "xxxxx",

　　　　"certificateType": "xxxxx

　　　　"birthDate": "xxxx",

　　　　"phone": "xxxx",

　　　　"gender": xxx,

　　　　"name": "xxx",

"userId": "xxx",

"chinaArea": "xxx",

"nationality": "xxx",

　　}]

}

3. 数据字典

3.1. 证件类型

3.2. 性别

3.3. 民族代码

3.4. 国籍

4. 数据加密方法

4.1. 加密描述

（1）　本文中所用到的数据加密采用SM4加密算法，加密密钥由省公共服务系统向应用分配，应用系统使用分配的密钥进行加密后传输数据，省公共服务系统收到数据后使用相同的密钥进行解密，反之省公共服务系统向应用系统返回数据时使用同样的方法加密

（2） 加密******医院的 appKey做为密钥

（3） 敏感信息加密 例：

a) 姓名

b) 电话

c) 微信号

d) 邮箱号

e) 电子健康码ID

4.2. 加密使用方法

以下为加密使用方法（SM4加密）

public static void main(String[] args) {

String params = "小明";

　　　　String key = "A7E2D00B******CBD3D4B8A5E0B2697";

　　　　try {

　　　　　　//加密

　　　　　　String cipher = Sm4Utils.encryptEcb(key,params);

　　　　　　System.out.println("加密后数据："+cipher);

　　　　　　//效验加密前后的字符串是否为同一数据

　　　　　　System.out.println(Sm4Utils.verifyEcb(key,cipher,params));

　　　　　　//解密

　　　　　　params = Sm4Utils.decrptEcb(key,cipher);

　　　　　　System.out.println("解密后数据："+params);

　　　　}catch (Exception e){

　　　　　　e.printStackTrace();

　　　　}

　　　　}

3、调研参与方式

1. 报名时间：2025年5月14日-5月21日；

2. 材料提交：公司资质证明、系统解决方案及报价、项目案例、联系人、联系方式；

3.报名联系人：刘晨晖 邮箱：******

4.咨询电话：******

******医院

                 2025年5月14日