成都市电子居民健康卡接入规范.docx
《成都市电子居民健康卡接入规范.docx》由会员分享，可在线阅读，更多相关《成都市电子居民健康卡接入规范.docx（25页珍藏版）》请在冰豆网上搜索。
成都市电子居民健康卡接入规范
成都市电子居民健康卡接入规范
附件
成都市电子居民健康卡接入规范
电子居民健康卡是居民健康卡的重要组成部分，是实体
居民健康卡互联网化、虚拟化、功能服务延伸的唯一载体，是信息便民服务的重要抓手。
为有效解决实体卡发卡难、促进居民健康卡使用率、丰富应用场景，规划采用“电子居民健康卡+实体居民健康卡+健康成都平台”相结合的方式开展建设与推广应用，实现成都市“同城通卡同应用”的目标。
第一部分应用场景设计
电子居民健康卡可以在以下多项医疗功能中实现重要支撑：
居民健康卡虚拟化
将居民健康卡实体卡与电子居民健康卡绑定，实现身份
的统一，数据的统一。
预约挂号身份识别
电子居民健康卡信息直接对接医院院内系统，生成院内
识别账号，实现用户在线建档、在线预约挂号。
个人健康档案查询
通过成都市人口信息平台账号与居民健康卡应对,通过
电子居民健康卡的用户安全管理，逐步开放部分个人健康信
息。
实时信息查询
根据医院现阶段就诊排队信息,通过电子居民健康卡识
别，为挂号用户及预约挂号用户提供排队信息查询，方便居民及时了解排队信息情况。
检查检验报告查询
通过电子居民健康卡与医院账号的应对，电子居民健康
卡用户在线查看自己报告是否生成，报告结果如何。
家庭医生签约管理
电子居民健康卡作为唯一标志，因对有关基层签约机
构，实现签约与账号的对应。
方便未来家庭医生建档、服务。
其他门诊服务
电子居民健康卡同时可以提供包含智能导诊、门诊缴费
记录、检查检验预约、检查检验排队、门诊缴费等其他院内实现的互联网服务的身份识别。
住院服务
“电子居民健康卡与院内档案打通，可通过电子居民健康
卡在线查询在院缴费押金、补缴记录、住院清单等住院部分
的数据查询。
医院有关信息
医院满意度、医生满意度等院内信息上报的身份识别
第二部分电子居民健康卡主索引平台接入功能说
明
成都市电子居民健康卡主索引平台（以下简称：
“主索引平台”）作为成都市卫计委健康成都平台的重要子系统之一，为电子居民健康卡提供身份识别、数据存储、实时互联等技术支撑和安全保障。
1功能描述
1.1.1概述
用户
服务商
主索引平台
卡管平台
绑卡
用户认证
健康卡信息识别
短信验证码
识别成功发送短信
提交验证码
校验验证码，成功保存数据
返回结果
-
『提交验证码
为了保护用户信息及相关数据，居民健康卡用户在健康成都平台前端或其它服务提供商进行居民健康卡绑定时，需要在健康成都平台的主索引平台进行用户认证，保证其用户信息真实性。
1.1.2功能设计
主索引平台将对卫计委认可的服务提供商开放网络端口访问权限及用户认证接口访问权限，并提供RESTFULL风格HTTPS接口及SOAP接口两种访问方式进行业务开放。
主索引平台认证规则：
A:
用户提交健康卡卡号及手机号与卡管平台登记的健康卡卡号及手机号相匹配。
B:
主索引平台将发送短信验证码到与健康卡卡号匹配的手机号上。
C:
用户提交手机号进行验证。
根据后期业务发展，主索引平台还将提供对用户提供诊疗记录验证及银联用户认证功能。
1.1.3角色定位
【主索引平台】：
主索引平台能力开放中心将提供电子居民健康卡用户认证接口，供健康成都平台及第三方调用。
【服务商】：
服务商根据主索引平台的接口文档研发电子居民健康卡用户认证接口，并提供相关业务页面供用户使用。
【卡管平台】：
卡管平台提供居民健康卡信息查询接口
1.2.1概述
判断是否认证用户
认证用户生成云卡
主索引平台支持多平台多服务商接入，对所有需使用电子居民健康卡业务的居民健康卡用户进行电子居民健康卡的发放业务。
服务商及健康成都平台获取到电子居民健康卡后在客户端生成二维码提供给用户使用
1.2.2功能设计
主索引平台将对卫计委认可的服务提供商开放网络端口访问权限及电子居民健康卡用户发卡接口访问权限，并提供RESTFULL风格Https接口及SOAP接口两种访问方式进行业务开放。
【主索引平台接口】：
主索引平台能力开放平台将提供
电子居民健康卡发卡接口供健康成都平台及第三方调用，请
参照电子居民健康卡用户发卡接口说明。
电子居民健康卡生成规则：
根据用户认证后的居民健康卡卡号，系统时间戳，加密私钥，采取对称加密算法，将居民健康卡卡号，有效时间加密成二维码识别串，有效时间为五分钟。
【服务商】：
服务商根据主索引平台接口文档，研发电子居民健康卡用户发卡接口，并提供相关业务页面供用户使用。
1.3电子居民健康卡用户识别
1.3.1概述
用户
医院窗口
服务商
主索引平台
1
1
出示云卡二维码
1
1
1
1
i
1
||
1
|
.扫码获取云卡信息
调用云卡识别接口
当用户使用二维码在医院窗口进行业务扫码后，窗口将
二维码字符串通过HIS传输到发卡中心进行用户识别。
1.3.2功能设计
主索引平台将对卫计委认可的服务提供商开放网络端口访问权限及用户识别接口访问权限，并提供RESTFULL风
格Https接口及SOAP接口两种访问方式进行业务开放。
1.3.3角色定位
【主索引平台接口】：
主索引平台能力开放平台将提供电子居民健康卡下行接口供健康成都平台及第三方调用，请
参照电子居民健康卡用户识别接口说明。
识别规则：
根据二维码识别串，使用发卡时的加密私钥进行解码，获得系统时间戳，居民健康卡卡号信息，并在后台服务判断用户是否是已通过认证的用户及时间有效性，有效时间为五分钟。
如果通过认证且时间在规定范围内，则返回居民健康卡卡号给医院端。
【服务商】：
服务商根据主索引平台接口文档研发电子居民健康卡用户识别接口，并提供对应接口页面供医院调用。
【医院】医院窗口需要能接受二维码，并通过服务商提
供的接口到主索引平台进行电子居民健康卡用户识别
第三部分电子居民健康卡接口标准
第一章概述
1.1范围
本文档适用于参与主索引平台能力开放平台设计和研发人员，系统维护人员及接入能力开放平台的外部应用的开发人员。
1.2起草单位
本文档的起草单位为成都市卫生和计划生育委员会。
1.3解释权
本文档的解释权属于成都市卫生和计划生育委员会。
1.4版权
本文档的版权属于成都市卫生和计划生育委员会
第二章接口
2.1概述
系统接口使用http、webservice方式，传送数据编码统一为UTF-8。
请求数据说明：
调用能力平台接口，有3个必传参数，分别是dcode
dkey、pocde。
dcode为安全访问参数设备编码。
dkey为安全访问参数设备密钥。
pcode为平台code,由能力开放平台提供。
响应数据说明：
{
"data":
{
II.1111
},"state":
1,
"msg":
"success"
返回数据格式说明：
data是主体数据，服务器响应客户端请求的具体业务数据。
state是响应代码，state为1表示成
功、非1表示失败。
msg是响应描述，成功时，提示请求成功，失败时，提示失败原因。
2.2电子居民健康卡
2.2.1用户识别
接口说明根据二维码字符串进行用户识别
接口地址
类型
接口地址
接口方法
http
crypt/decrypt.do
webservice
crypt/decrypt?
wsdl
decrypt
输入参数
字段
说明
可否
为空
备注
dcode
设备编码
否
安全访问参数（设备
编码）
dkey
设备密钥
否
安全访问参数（设备
密钥）
pcode
平台编码
否
平台编码
hid
医疗机构代码
否
医疗机构代码
encrypt
二维码字符串
否
扫描二维码后获得
的加密字符串
返回参数
JSON格式
字符串
见返回参数说明。
返回数据格式
字段
说明
可否为空
备注
state
结果代码
否
1成功
非1失败
msg
结果描述
否
成功时，提示请求
成功
失败时，提示失败
原因
data
返回结构
否
响应请求的具体数
据
data结构体说明
属性
类型
可否为空
备注
idCard
String
否
身份证
username
String
否
姓名
psnGen
String
否
性别
birthday
String
否
出生日期
nationCode
String
否
民族
addressl
String
否
家庭地址
address2
String
是
户口地址
psnNamel
String
是
联系人姓名
psnRell
String
是
联系人关系
psnPhone
String
是
联系人电话
degree
String
是
文化程度
marry
String
是
婚姻状况
job
String
是
职业
cnum
String
否
卡号
cardType
String
否
卡类型
输出举例
{
"data":
{
"address1":
"",
"address2":
"","nationCode":
"","username":
"","psnName1":
"",
"marry":
"","idCard":
""
"psnRell":
"","psnPhonel":
"""psnGen":
"","job":
"",
"birthDay":
"",
"degree":
"",
avvv
cnum,,
cardType:
},
"state":
1,
"msg":
"success
2.2.2用户加密
接口说明根据用户信息进行加密
接口地址
类型
接口地址
接口方法
http
crypt/encrypt.do
webservice
crypt/encrypt?
wsdl
encrypt
输入参数
字段
说明
可否为
空
备注
dcode
设备编码
否
安全访问参数（设备
编码）
dkey
设备密钥
否
安全访问参数（设备
密钥）
pcode
平台编码
否
平台编码
uid
平台用户ID
否
平台用户ID
idcard
用户身份信
息
否
用户身份信息
返回参数
JSON格式
字符串
见返回参数说明。
返回数据格式
字段
说明可否为
备注
空
state
结果代码
否
1成功
非1失败
msg
结果描述
否
成功时，提示请求
成功
失败时，提示失败
原因
data
返回结构
否
响应请求的具体数
据
data结构体说明
属性
类型
可否为
空
备注
encrypt
String
否
加密后的用户信息
输出举例
{
"data":
{
"encrypt":
""
},
"state":
1,"msg":
"success
2.2.3用户认证1.0
2.2.3.1获取认证码
接口说明用户认证获取认证码
接口地址
类型
接口地址
接口方法
http
crypt/code.do
webservice
crypt/code.wsdl
code
输入参数
字段
说明
可否为空
备注
dcode
设备编码
否
安全访问参数（设
备编码）
dkey
设备密钥
否
安全访问参数（设
备密钥）
pcode
平台编码
否
平台编码
uid
平台用户ID
否
平台用户ID
idcard
用户身份信息
否
用户身份信息
phone
用户手机号
否
用户手机号
name
用户姓名
否
用户姓名
返回参数
JSON格式
字符串
见返回参数说明。
返回数据格式
字段
说明
可否为空
备注
state
结果代码
否
1成功
非1失败
msg
结果描述
否
成功时，提示请求
成功
失败时，提示失败
原因
data
返回结构
否
响应请求的具体
数据
data结构体说明
属性
类型
可否为空
备注
vtoken
String
否
验证码token
输出举例
{
"data":
{
“vtoken”：
"Cd18904806a1b4306a1f7fc4741caef1"
},
"state":
1,
"msg":
"success"
2.2.3.2提交认证码
接口说明提交认证码，完成认证
接口地址
类型
接口地址
接口方法
http
crypt/auth.do
webservice
crypt/auth.wsdl
auth
输入参数
字段
说明
可否为空
备注
dcode
设备编码
否
安全访问参数（设
备编码）
dkey
设备密钥
否
安全访问参数（设
备密钥）
pcode
平台编码
否
平台编码
vtoken
验证码token
否
验证码token，调用
获取验证码接口后
返回
vcode
验证码
否
调用获取验证码接
口后，向用户手机
发送的验证码
返回参数
JSON格式
字符串
见返回参数说明。
返回数据格式
字段
说明
可否为空
备注
state
结果代码
否
1成功
非1失败
msg
结果描述
否
成功时，提示请求
成功
失败时，提示失败
原因
输出举例
{
"state":
1,
"msg":
"success"
}
2.2.4用户认证2.0
2.2.4.1获取认证题目
接口说明用户认证获取认证题目
接口地址
类型
接口地址
接口方法
http
crypt/getQues.do
webservice
crypt/getQues.wsdl
getQues
输入参数
字段
说明
可否为空
备注
dcode
设备编码
否
安全访问参数（设
备编码）
dkey
设备密钥
否
安全访问参数（设
备密钥）
pcode
平台编码
否
平台编码
uid
平台用户ID
否
平台用户ID
idcard
用户身份信
息
否
用户身份信息
phone
用户手机号
否
用户手机号
name
用户姓名
否
用户姓名
返回参数
JSON格式
字符串
见返回参数说明。
返回数据格式
字段
说明可否为空
备注
state
结果代码
否
1成功
非1失败
msg
结果描述
否
成功时，提示请求
成功
失败时，提示失败
原因
data
返回结构
否
响应请求的具体
数据
data结构体说明
属性
类型
可否为空
备注
quCode
String
否
问题编号
question
String
否
问题描述
Item
String
否
答案选项
输出举例
{
"data":
[
{
"quCode":
"961674102731204",
"question":
"下面那个科室是你2015年5月17日在成都市第一人民医院就诊的科室",
"item":
[
"消化内科",
"儿科",
"泌尿内科",
"外科"
]
},
{
"quCode":
"638439651063459",
"question":
"你于2015年4月13日在哪个医院的
消化科就诊？
"，
"item":
[
"成都市第一人民医院",
"成都市第二人民医院",
"成都市第三人民医院",
"成都市第四人民医院"
]
}
],
"state":
1,
"msg":
"success"
}
2.2.4.2提交认证答案
接口说明用户认证获取认证题目
接口地址
类型
接口地址
接口方法
http
crypt/saveResult.do
webservice
crypt/saveResult.wsdl
saveResult
输入参数
字段
说明
可否为
空
备注
dcode
设备编码
否
安全访问参数（设备
编码）
dkey
设备密钥
否
安全访问参数（设备
密钥）
pcode
平台编码
否
平台编码
uid
平台用户ID
否
平台用户ID
idcard
用户身份信
息
否
用户身份信息
jsonArr
认证答案
否
认证答案
jsonArr格
式范例
[
{
"quCode":
"961674102731204",
"answer":
"消化内科"
},{}…
]
返回参数
JSON格式
字符串
见返回参数说明。
返回数据格式
字段
说明
可否为空
备注
state
结果代码
否
1成功
非1失败
msg
结果描述
否
成功时，提示请求
成功
失败时，提示失败
原因
输出举例
{
"state":
1,
"msg":
"success
2.2.5用户销卡
接口说明根据用户信息进行加密
接口地址
类型
接口地址
接口方法
http
crypt/removeCard.do
webservice
crypt/removeCard?
wsd
l
removeCard
输入参数
字段
说明
可否为空
备注
dcode
设备编码
否
安全访问参数（设备
编码）
dkey
设备密钥
否
安全访问参数（设备
密钥）
pcode
平台编码
否
平台编码
uid
平台用户ID
否
平台用户ID
idcard
用户身份信
息
否
用户身份信息
phone
用户手机号
否
用户手机号
name
用户姓名
否
用户姓名
返回参数
JSON格式见返回参数说明。
字符串
返回数据格式
字段
说明
可否为
空
备注
state
结果代码
否
1成功
非1失败
msg
结果描述
否
成功时，提示请求
成功
失败时，提示失败
原因
输出举例
{
"state":
1,
"msg":
"success
附表
返回状态码说明
状态码
描述
1
请求成功
-1
服务器异常
40001
XXX参数不合法的参数值
40002
XXX参数值为空
40004
时间过期
40005
不合法的ip地址
40007
未认证的平台用户
50001
消息发送次数过多
50002
验证码验证失败
50003
已验证，无需重新验证
50004
身份证已存在
50005
健康卡已存在
50006
手机号已存在
50007
验证未通过，请确认验证信息
50008
手机号错误，不是健康卡绑定手机
号
50009
问题或许已过期，请重新获取问题
并验证
50010
输入的字符太长
50011
健康卡无效，详情请咨询卡管中心
50012
注销失败，请确认输入信息
50013
答案有误，验证失败
升级会员 