|
惠州市第三人民醫(yī)院
關于互聯(lián)網(wǎng)醫(yī)院接入粵健通的接口程序項目的市場調(diào)研公示
我院擬采購互聯(lián)網(wǎng)醫(yī)院接入粵健通的接口程序項目，現(xiàn)面向社會公開征集供應商參與市場調(diào)研，為后續(xù)招標及實施提供參考。具體事項如下：
1、項目名稱:互聯(lián)網(wǎng)醫(yī)院接入粵健通的接口程序項目
2、主要內(nèi)容:
|
項目名稱
|
數(shù)量
|
單位
|
|
互聯(lián)網(wǎng)醫(yī)院接入粵健通的接口程序項目
|
1
|
個
|
主要技術參數(shù)及要求
1. 對接內(nèi)容
1.1. 工作目標與任務
廣東省全民健康信息綜合管理平臺公共服務系統(tǒng)實現(xiàn)全省健康公共服務管理，為全省居民提供如預約掛號、健康檔案查詢、家庭醫(yī)生簽約、免疫接種、智能導診、移動支付、隨訪等各類基于電子健康碼的醫(yī)療健康互聯(lián)網(wǎng)服務。
本指引主要針對互聯(lián)網(wǎng)醫(yī)院與省衛(wèi)生健康委健康公共服務小程序“粵健通”的單點對接。
1.2. 對接前置條件
1.2.1. 業(yè)務系統(tǒng)接入注冊
由項目組完成相關配置后，分配業(yè)務系統(tǒng)應用標識(appCode)和敏感信息加密秘鑰(appKey)等相關信息。
1.3. 單點登錄
1.3.1. 跳轉(zhuǎn)鏈接
1.3.1.1. 業(yè)務場景
用戶在“粵健通”小程序內(nèi)點擊業(yè)務系統(tǒng)鏈接并完成刷臉登錄后，跳轉(zhuǎn)到業(yè)務系統(tǒng)相關頁面時，業(yè)務系統(tǒng)通過用戶認證相關信息實現(xiàn)單點登錄功能。
1.3.1.2. 業(yè)務流程
業(yè)務系統(tǒng)與“粵健通”小程序通過電子完成單點登錄認證的流程如下：
1. 用戶點擊業(yè)務系統(tǒng)鏈接后，由“粵健通”小程序完成刷臉認證登錄流程；
2. 刷臉認證后，“粵健通”小程序調(diào)用服務端，獲取此次會話的code(5分鐘有效)；
3. “粵健通”小程序在業(yè)務系統(tǒng)鏈接url后拼接上code參數(shù)，例如業(yè)務系統(tǒng)鏈接為“http://www.baidu.com”,則拼接code后的鏈接為“http://www.baidu.com?code=afadsgfaar”；
4. 業(yè)務系統(tǒng)前端從請求url中獲取code值并傳入業(yè)務系統(tǒng)服務端，業(yè)務系統(tǒng)服務端調(diào)用code換取用戶認證信息接口，獲取用戶認證類型和認證代碼；
5. 業(yè)務系統(tǒng)服務端解密用戶認證信息后，完成系統(tǒng)內(nèi)部的賬號認證流程。
2. 接口定義
2.1. 協(xié)議
與“粵健通”小程序系統(tǒng)通信協(xié)議，使用HTTPS協(xié)議。
2.2. 請求響應報文格式
接口正常響應的報文，規(guī)定以標準JSON格式字符串返回。其中，
1． 字符串編碼格式統(tǒng)一使用UTF-8；
2． 按照API網(wǎng)關接入規(guī)范要求，請求“粵健通”接口的請求頭，均需增加網(wǎng)關相關請求參數(shù)，網(wǎng)關接入?yún)?shù)如下表所示：
|
參數(shù)名
|
必填
|
數(shù)據(jù)格式
|
類型范圍
|
說明
|
|
x-tif-nonce
|
是
|
{nonce}
|
String
|
請求參數(shù)隨機字符串，用于校驗請求簽名
|
|
x-tif-signature
|
是
|
{singature}
|
String
|
請求參數(shù)簽名值，具體規(guī)則請參考《網(wǎng)關接入工具包》的相關內(nèi)容
|
|
x-tif-paasid
|
是
|
{paasid}
|
String
|
當前業(yè)務系統(tǒng)的網(wǎng)關標識
|
|
Content-type
|
是
|
application/json;charset=utf-8
|
String
|
文件拓展名，默認application/json
|
|
x-tif-timestamp
|
是
|
{timestamp}
|
String
|
應用程序發(fā)出請求的客戶端時間
|
2.3. 錯誤碼定義
|
錯誤碼
|
描述
|
|
0
|
成功
|
|
1
|
失敗
|
|
2
|
參數(shù)不合法
|
|
3
|
驗簽失敗
|
2.4. 接口文檔
2.4.1. code換取用戶認證信息
2.4.1.1. 描述
業(yè)務系統(tǒng)通過此接口，以code換取病人健康碼信息后，完成系統(tǒng)內(nèi)的賬號認證流程。
2.4.1.2. URL
測試環(huán)境：https://bs-test.digitalgd.com.cn/ebus/health/facade?command=01
正式環(huán)境：https://apis.gdzwfw.gov.cn/ebus/health/facade?command=01
2.4.1.3. 協(xié)議類型
GET協(xié)議
2.4.1.4. 請求參數(shù)
|
參數(shù)名
|
必填
|
類型
|
描述
|
|
appCode
|
是
|
String(10)
|
系統(tǒng)編碼，業(yè)務系統(tǒng)接入時由”粵健通”系統(tǒng)分配
|
|
code
|
是
|
String(32)
|
認證code，5分鐘內(nèi)有效
|
|
businessType
|
是
|
Integer
|
業(yè)務類型：
1：預約掛號；（互聯(lián)網(wǎng)醫(yī)院接入按此業(yè)務類型）
2：健康檔案查詢；
3：家庭醫(yī)生簽約；
4：免疫接種；
5：雙向轉(zhuǎn)診；
6：母子E手冊；
7：智慧結控；
8：醫(yī)療廢棄物；
9：中醫(yī)藥局
10：獎勵扶助
11：托育
12：健康深圳《新冠預約》
……
|
2.4.1.5. 響應報文內(nèi)容
|
字段名
|
必填
|
類型
|
描述
|
|
errcode
|
是
|
Integer
|
響應編碼。響應成功為0；響應錯誤詳見本文2.3錯誤碼定義列表
|
|
errmsg
|
是
|
String(100)
|
響應結果描述，詳見本文2.3錯誤碼定義列表
|
|
data
|
否
|
Object
|
響應成功時，返回的業(yè)務數(shù)據(jù)
|
data
|
參數(shù)名
|
類型
|
描述
|
|
certificateNo
|
String(64)
|
證件號碼，SM4算法加密
|
|
certificateType
|
String(5)
|
證件類型，詳見3.1數(shù)據(jù)字典
|
|
healthCardNo
|
String(128)
|
電子健康碼
|
|
phone
|
String(50)
|
手機號碼，SM4加密
|
|
name
|
String(128)
|
用戶姓名
|
|
gender
|
Integer
|
性別，詳見3.2數(shù)據(jù)字典
|
|
nation
|
String(5)
|
民族 詳見章節(jié)“3.3民族代碼
|
|
userId
|
String(20)
|
粵健通用戶ID
|
|
channel
|
String(5)
|
渠道，1內(nèi)地、2港澳、3臺灣、4外籍
|
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. 描述
業(yè)務系統(tǒng)通過此接口，以用戶ID獲取用戶新冠預約檔案信息。
2.4.2.2. URL
測試環(huán)境：https://bs-test.digitalgd.com.cn/ebus/health/facade?command=27
正式環(huán)境：https://apis.gdzwfw.gov.cn/ebus/health/facade?command=27
2.4.2.3. 協(xié)議類型
POST協(xié)議
2.4.2.4. 請求參數(shù)（body）
|
參數(shù)名
|
必填
|
類型
|
描述
|
|
appCode
|
是
|
String(10)
|
系統(tǒng)編碼，業(yè)務系統(tǒng)接入時由”粵健通”系統(tǒng)分配
|
|
userId
|
是
|
String(32)
|
粵健通用戶ID
|
2.4.2.5. 響應報文內(nèi)容
|
字段名
|
必填
|
類型
|
描述
|
|
errcode
|
是
|
Integer
|
響應編碼。響應成功為0；響應錯誤詳見本文2.3錯誤碼定義列表
|
|
errmsg
|
是
|
String(100)
|
響應結果描述，詳見本文2.3錯誤碼定義列表
|
|
data
|
否
|
Array
|
響應成功時，返回的業(yè)務數(shù)據(jù)
|
data
|
參數(shù)名
|
類型
|
描述
|
|
certificateNo
|
String(64)
|
證件號碼，SM4算法加密
|
|
certificateType
|
String(5)
|
證件類型，詳見3.1數(shù)據(jù)字典
|
|
birthDate
|
String(128)
|
出生日期(yyyy-mm-dd)
|
|
phone
|
String(50)
|
手機號碼，SM4加密
|
|
name
|
String(128)
|
用戶姓名
|
|
gender
|
Integer
|
性別，詳見3.2數(shù)據(jù)字典
|
|
userId
|
String(20)
|
粵健通用戶ID
|
|
chinaArea
|
String(5)
|
大陸地區(qū)(1內(nèi)地，2香港，3澳門，4臺灣)
|
|
nationality
|
String(10)
|
國籍
|
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. 數(shù)據(jù)字典
3.1. 證件類型
|
值含義
|
值
|
說明
|
|
居民身份證
|
01
|
|
|
居民戶口簿
|
02
|
|
|
護照
|
03
|
|
|
軍官證
|
04
|
|
|
駕駛證
|
05
|
|
|
港澳居民來往內(nèi)地通行證
|
06
|
|
|
臺灣居民來往內(nèi)地通行證
|
07
|
|
|
出生醫(yī)學證明
|
08
|
|
|
其他法定有效證件
|
99
|
|
3.2. 性別
|
值含義
|
值
|
說明
|
|
男
|
1
|
|
|
女
|
2
|
|
|
保密
|
3
|
|
|
未知
|
4
|
|
3.3. 民族代碼
|
值含義
|
值
|
說明
|
|
漢族
|
01
|
|
|
蒙古族
|
02
|
|
|
回族
|
03
|
|
|
藏族
|
04
|
|
|
維吾爾族
|
05
|
|
|
苗族
|
06
|
|
|
彝族
|
07
|
|
|
壯族
|
08
|
|
|
布依族
|
09
|
|
|
朝鮮族
|
10
|
|
|
滿族
|
11
|
|
|
侗族
|
12
|
|
|
瑤族
|
13
|
|
|
白族
|
14
|
|
|
土家族
|
15
|
|
|
哈尼族
|
16
|
|
|
哈薩克族
|
17
|
|
|
傣族
|
18
|
|
|
黎族
|
19
|
|
|
傈僳族
|
20
|
|
|
佤族
|
21
|
|
|
畬族
|
22
|
|
|
高山族
|
23
|
|
|
拉祜族
|
24
|
|
|
水族
|
25
|
|
|
東鄉(xiāng)族
|
26
|
|
|
納西族
|
27
|
|
|
景頗族
|
28
|
|
|
柯爾柯孜族
|
29
|
|
|
土族
|
30
|
|
|
達爾族
|
31
|
|
|
仫佬族
|
32
|
|
|
羌族
|
33
|
|
|
布朗族
|
34
|
|
|
撒拉族
|
35
|
|
|
毛南族
|
36
|
|
|
仡佬族
|
37
|
|
|
錫伯族
|
38
|
|
|
阿昌族
|
39
|
|
|
普米族
|
40
|
|
|
塔吉克族
|
41
|
|
|
怒族
|
42
|
|
|
烏孜別克族
|
43
|
|
|
俄羅斯族
|
44
|
|
|
鄂溫克族
|
45
|
|
|
德昂族
|
46
|
|
|
保安族
|
47
|
|
|
裕固族
|
48
|
|
|
京族
|
49
|
|
|
塔塔爾族
|
50
|
|
|
獨龍族
|
51
|
|
|
鄂倫春族
|
52
|
|
|
赫哲族
|
53
|
|
|
門巴族
|
54
|
|
|
珞巴族
|
55
|
|
|
基諾族
|
56
|
|
|
其它民族或外國人
|
99
|
|
3.4. 國籍
4. 數(shù)據(jù)加密方法
4.1. 加密描述
（1） 本文中所用到的數(shù)據(jù)加密采用SM4加密算法，加密密鑰由省公共服務系統(tǒng)向應用分配，應用系統(tǒng)使用分配的密鑰進行加密后傳輸數(shù)據(jù)，省公共服務系統(tǒng)收到數(shù)據(jù)后使用相同的密鑰進行解密，反之省公共服務系統(tǒng)向應用系統(tǒng)返回數(shù)據(jù)時使用同樣的方法加密
（2） 加密Key，分配至地市/醫(yī)院的 appKey做為密鑰
（3） 敏感信息加密 例：
a) 姓名
b) 電話
c) 微信號
d) 郵箱號
e) 電子健康碼ID
4.2. 加密使用方法
以下為加密使用方法（SM4加密）
public static void main(String[] args) {
String params = "小明";
String key = "A7E2D00B4058086CBD3D4B8A5E0B2697";
try {
//加密
String cipher = Sm4Utils.encryptEcb(key,params);
System.out.println("加密后數(shù)據(jù)："+cipher);
//效驗加密前后的字符串是否為同一數(shù)據(jù)
System.out.println(Sm4Utils.verifyEcb(key,cipher,params));
//解密
params = Sm4Utils.decrptEcb(key,cipher);
System.out.println("解密后數(shù)據(jù)："+params);
}catch (Exception e){
e.printStackTrace();
}
}
3、調(diào)研參與方式
1. 報名時間：2025年5月14日-5月21日；
2. 材料提交：公司資質(zhì)證明、系統(tǒng)解決方案及報價、項目案例、聯(lián)系人、聯(lián)系方式；
3.報名聯(lián)系人：劉晨暉 郵箱：437648367@QQ.COM
4.咨詢電話：0752-2583164
惠州市第三人民醫(yī)院
2025年5月14日
|
