广东省电子健康码管理平台移动应用接入改造指引

1、XX省电子健康码管理平台移动应用接入改造指引（2021年）目 录 TOC o 1-3 h z u HYPERLINK l _Toc68708487 1.概述 概述本文档作为电子健康码移动应用接入XX省电子健康码管理平台（以下简称省级码管平台）改造指引，编写的目的是为了明确电子健康码移动应用接入需要改造的内容和改造要求，以完成在移动应用上实现电子健康码注册领码、二维码展示等。适用范围本文仅适用于直接接入省级码管平台的电子健康码移动应用，如微信公众号/小程序、支付宝生活号/服务号、银行移动应用、运营商移动应用等第三方的相关移动应用。约束与限制以XX省电子健康码管理平台建设标准规范（下文简称标准规范

2、）为基础，在此文档未尽描述的内容以标准规范为准。应用系统按照指引中相关要求进行改造完成电子健康码业务应用。数据加密和签名本文所用到的数据加密采用 SM4 加密算法，加密密钥由电子健康码管理平台向接入应用分配。对于关键的隐私数据（例如身份证号码、姓名、证件号码等，详见接口参数备注中的描述），应用系统使用分配的密钥进行加密后传输数据，电子健康码管理平台收到数据后使用相同的密钥进行解密；反之电子健康码管理平台向应用系统返回数据时使用同样的方法加密。数据签名使用SM3散列算法，签名分为请求头部信息签名和上传信息签名。系统在不同场景下依据安全级别选择不同的验签级别。注：1、接口中的加解密、签名可由应用系

3、统自行完成或通过码管平台的前置系统完成。2、应用系统自行完成时使用的 SM4 和 SM3 为标准算法，应用开发人员依个人方式实现即可；此时前置系统模式配置为透传模式，仅做请求转发不做数据处理。3、当前置服务器部署在机构内部，可确保应用系统到前置服务器之间的通信安全时，可采用前置系统加密模式。此时前置系统模式配置为加密模式，应用系统请求时接口中标注为加密的字段均直接传输明文，签名参数（头部信息签名、上传信息签名）、签名模式、加密模式均传“none”，由前置系统代为完成加密、解密、签名。数据元属性规范内部标识符：指数据元在某特定数据集中的唯一标识代码。数据元名称：数据元名称应当是唯一的，并且以字母

4、、汉字、数字式的字符串形式表示。数据元的命名应使用一定的逻辑结构和通用的术语。数据类型：数据类型描述规则见表 1。本文件将字符型（S）分为三种形式，S1表示不可枚举的，且以字符描述的形式；S2 表示枚举型，且列举值不超过 3 个；S3 表示代码表的形式。第第7040页系统改造综述改造目标移动应用按照接口标准进行接口改造，接入XX省电子健康码管理平台，完成在移动应用上实现电子健康码注册领码、二维码展示等应用。改造内容改造内容包括硬件设施、网络支持改造、移动应用接入改造。主要业务描述电子健康码注册申领居民使用移动应用通过省级码管平台提供的接口服务，实现相关注册申领应用的调用及整合，完成电子健康码的

5、注册申领。省级码管平台接受注册信息后，查询系统是否存在该用户，如存在将电子健康码 ID 和主索引 ID 等返回；如不存在省级码管平台生成主索引和电子健康码 ID，使用用户身份信息完成用户注册，并返回上述信息。移动端应用将接收到的电子健康卡ID与本地用户关联保存，完成电子健康码注册申领；个人移动端应用需要显示二维码时，通过电子健康码 ID 向省级码管平台申请动态二维码。个人移动端应用需要查询个人的信息时，通过电子健康码 ID 向省级码管平台申请个人信息查询。电子健康码使用居民在个人移动端应用上出示二维码时，移动端应用通过电子健康卡ID向省级码管平台申请动态二维码，省级码管平台验证请求身份后加密生

6、成动态二维码字符串返回给个人移动端应用，移动端将二维码串转换成二维码图片进行展示。居民出示此二维码进行电子健康码的使用。移动应用接入改造说明硬件设施移动端应用根据网络规划需求配备前置机，搭建前置系统。前置机需根据业务量评估合理配置，确保满足移动端应用的业务需求。前置机需要能够通过安全网络访问电子健康码管理平台，如移动端应用的服务器可直连访问省级码管系统时，可直接访问远端前置系统接入（此时应用系统必须自己完成加解密和签名）前置机支持Windows 2012 server及以上版本、CentOS 6.9以以上版本、国产操作系统与软件。数据库支持Mysql 8.0及以上版本。网络支持移动端应用后台服

7、务应与XX省电子健康码管理平台通过安全网络互连；移动端应用居民端与后台服务应通过基于公网的S连接。移动应用接入改造移动应用按照接入规范进行接口改造，完成在移动应用上实现电子健康码注册领码、二维码展示。移动应用接入规范总体描述1、下文接口地址描述中均使用 协议，实际生产环境中多数情况使用s 安全协议，请对接时注意支持 和 s 协议。2、下文接口描述均以应用系统自行进行加解密、签名的方式描述，如使用前置系统加解密、签名方式的加密。3、所有接口备注栏标“Y”的为必填项，未标注的为选填项。4、所有接口备注栏标注为传输代码的需要按照备注说明或数据字典传输代码，其它未标注的默认直接传输对应字段的内容。5、

8、所有接口备注栏标“加密”字样的均需加密后传输，未标注的直接明文传输。6、所有接口备注栏标“不签名”字样的参数不参与签名，未标注的均需要参与签名。7、个人移动终端注册申请电子健康码动态二维码时，建议使用如下接口： 电子健康码注册（createVmcardQRcode）必选电子健康码个人信息修改（modifyVmcardInfo）必选电子健康码二维码获取（getActiveQrCode）必选电子健康码个人信息查询（getPersonInfo）必选电子健康卡卡号重置（resetVmcardInfo）必选8、个人移动端或智能终端扫码实现身份识别时，使用如下接口：电子健康码二维码验证（getPerson

9、InfoByQrCode）必选9、系统调试时使用的测试地址为： HYPERLINK :/39.98.156.33:8099/api/do :/39.98.156.33:8099/api/do10、系统改造在测试环境调试通过后发放正式环境地址。页面规范 2显示（44* 图 B.1 卡面参考布局 图 B.2 卡面尺寸（单位：px/像素） 图 B.3 电子健康卡展示界面 表 B.1 卡面参数布局参数（单位：px/像素） 参数规格及要求 卡面 卡面宽度 620px 卡面高度 350px 卡面圆角 10px 通用标识区 “省（市）级卫生健康行政管理部门名称”字体 苹方中黑体（18Px） “省（市）级卫生

10、健康行政管理部门名称”区域左边沿到卡的左边沿的距离 34px “省（市）级卫生健康行政管理部门名称”区域上边沿到卡的上边沿的距离 32px “省（市）级卫生健康行政管理部门名称”区域高度 25px 持卡人个人信息区 “姓名”字体 苹方中黑体（36Px），掩码显示：第 2 个字采用*显示 “证件号码”字体 4位，均采用*显示 “姓名”、 “证件号码”左边沿到卡的左边沿的距离 35px “姓名”上边沿到卡的上边沿的距离 202px “姓名”、 “证件号码” 的行间距 2px 参数规格及要求 “姓名、证件号码”字色值 2B2B2B 二维码区 二维码区域宽度 162px 二维码区域高度 162px 二

11、维码描边 4px Logo 宽度 44px Logo 高度 44px Logo 圆角 8px Logo 描边 4px 备注：logo 图片的大小不应影响二维码的译码 监制机构区 “监制机构”字体 苹方中黑体（18 Px） “监制机构”字间距 0 “监制机构”下边沿距卡的下边沿的距离 18px “监制机构”水平方向 与电子健康卡的卡面区域内居中 “监制机构”左边沿到卡的左边沿的距离 142px “监制机构”上边沿到卡的上边沿的距离 309px 电子健康卡标识区 电子健康卡图片标识红色部分色号 ED1C24 “电子健康卡及标识”区域 卡片右上区域 “电子健康卡图片标识”上边沿距卡上边沿 23px

12、“电子健康卡图片标识”左边沿距卡左边沿 380px “电子健康卡”文字上边沿距卡上边沿 29px “电子健康卡及标识” 左边沿距卡左边沿 443px 电子健康码注册（createVmcardQRcode）接口介绍接口地址:/ip:port/api/do接口方法 接口 POST 方法接口描述上传个人信息完成账户注册，获取电子健康码和主索引。接口提供者XX省电子健康码管理平台请求参数名称说明数据类型及长度备注（Y-必填）appId应用唯一识别码AN.36Y 由卡管系统分配timestamp请求时间戳AN.32Y 加密当前秒数，与标准时间一致nonceStr随机数AN.32Y 小于16位的整数ver

13、sion接口版本号AN.10Y 同文档版本，例V1.0.6method方法名称AN.50Y 不签名例 createVmcardQRcodeheadSign头部信息签名AN.32Y 不签名详见数据签名方法bodySign上传信息签名AN.32Y 不签名详见数据签名方法signMode数据签名模式AN.32Y 不签名详见数据签名方法encryptMode数据加密模式AN.32Y 不签名详见数据加密方法上传数据name姓名AN.32Y 加密idCode证件号码AN.32Y personnelType为2时可为空。加密idCardTypeCode证件类别AN.2Y personnelType为2时可为

14、空。见附录身份证件类别代码（V1.1版本增加了类别）validStartdate证件有效期开始时间T8YYYYMMDDvalidEnddate证件有效期结束时间T8YYYYMMDDidInst发证机关AN.128sex性别AN.2见附录7.5 性别编码（GB2261）nation民族AN.20Y 见附录7.7 民族代码birthday出生日期T8YYYYMMDDbirthplace出生地AN.200phone本人手机号AN.11不为空时需加密处理，加密linkman联系人姓名AN.50不为空时需加密处理，加密telephone联系人电话AN.11不为空时需加密处理，加密maritalstatu

15、scode婚姻状态AN.2GBT 2261-2003婚姻状况代码address户籍地址AN.128同身份证地址currentAddress居住地址AN.128现住地址idPhoto证件照片CLOB转为 base64scenePhoto头像照片CLOB转为 base64nationality国籍AN.50预留字段，默认中国，可空。language语言AN.50预留字段，默认汉语，可空。personnelType人员类型AN.2Y1:普通 2:无证件儿童仅无身份证件时按2传参，有身份证件时均按1传参。multifetalMark多胎标记AN.2人员类型为2时必填传输代码：0（单胎）1（多胎）mul

16、tpripleBirths多胎产次AN.2多胎标记为1时必填产次顺序号：例1、2、3motherName母亲姓名AN.50加密 人员类型为2时必填motherIdCode母亲身份证号AN.32加密 人员类型为2时必填motherEmpi母亲主索引IDAN.64人员类型为2时，与身份证号二选一填写。appMode操作方式AN.2Y 传输代码1、APP在线申请2、医疗卫生机构自助机申请3、医疗卫生机构窗口申请4、批量预生成5、微信服务号6、微信小程序7、支付宝生活号8、支付宝小程序9、其他payAccType绑定的或者支持的支付账户类型 AN.3预留字段默认为 00、无 1、微信2、支付宝3、银联

17、4、银行5、统一支付平台9 、 其 他 可多选，格式如下举例 1：12 举例 2：125 orgCode机构唯一识别码AN.36Y由应用机构注册备案过的机构唯一识别码appRecordNo应用备案号AN.17Y由应用注册备案过的应用唯一识别码guardianName监护人姓名AN.50加密（V1.1）guardianIdcode监护人身份证号AN.18加密（V1.1）guardianPhone监护人AN.11加密（V1.1）provinceCode居住省份代码AN.10参照中华人民共和国行政区划代码（GBT2260-2013）（9位区划代码）（V1.1）addressCityCode居住城市代

18、码AN.10参照中华人民共和国行政区划代码（GBT2260-2013）（9位区划代码）（V1.1）countyCode居住县区代码AN.10参照中华人民共和国行政区划代码（GBT2260-2013）（9位区划代码）（V1.1）professionType职业类型AN.3传输代码国家机关、党群组织、企、事业单位负责人专业技术人员办事人员和有关人员商业、服务业人员农、林、牧、渔、水利业生产人员生产、运输设备操作人员及有关人员军人不便分类的其他从业人员无职业见附录职业代码（V1.1）recognizeFlag是否实名认证AN.11如已经实名认证，认证渠道为必传（传输代码）0.尚未实名认证认证渠道：1

19、、微信认证2、银联认证3、支付宝认证4、公安认证9、其他认证（V1.1）请求格式method:createVmcardQRcode，headSign:a7c4b5d2831ea83b45b262e668a703226597a206db66135cb19c7610ea56bc9f，bodySign:d55a6a76cd50047480b5463a87eacf4c5566bc8d9d2d9060a74ea1c33bf1462c，appId:60C90F3B796B41878B8D9C393E2B6329，version:V3.5.0，nonceStr:1234567890，timestamp:60

20、C90F3B796B41878B8D9C393E2B6329，signMode:SM3，encryptMode:SM4/ECB/ZeroBytePadding，body: name:0D9D0E0B16DE2723FF5F73627CF176D7，idCode:0017F553626DCD34758A9EF58E302D00C384D17EC2CB2CCCB6DEB87EEBC60849， idCardTypeCode:01， validStartdate:20200818， validEnddate:20300818， idInst:XX市XX区公安局， sex:1， nation:， bi

21、rthday:19590423， birthplace:XX省XX市越秀区， phone:AA81286EC0B879E510C16C1D3910E88A， linkman:1129912DC06661F49ECE6AF71F930F37， telephone:99FF4574E2D3D2E9BEC1B5BB722AE66A， maritalstatuscode:20， address:XX省XX市越秀区， currentAddress:XX省XX市越秀区， idPhoto:X110， scenePhoto:X110， nationality:中国， language:汉语， personne

22、lType:1， multifetalMark:， multpripleBirths:， motherName:， motherIdCode:， appMode:1， payAccType:2， orgCode:c7781c38525c40ebbf208cb0afa0c722， appRecordNo:1504A00350002， guardianName:F8D04412B2FB1AC0D3AD371278CCBD81，guardianIdcode:4CD8626D03E8203E78E5A7909DC2BCA82622730932BDB5302B5A4EE308944ECC， guardi

23、anPhone:B49C8B476F06C7B46E7EA74AEECBC0A7， professionType:1， provinceCode:440000000， addressCityCode:440100000， countyCode:440104000， recognizeFlag:1响应参数属性名称中文名称备注说明returnCode交易结果0：成功 非 0：不成功returnDesc对错误或异常的描述信息signString数据签名，签名发放见附录数据签名方法timestamp响应时间戳建议验证datasdatas 数据erhcCardNo电子健康码IDempi主索引IDqrCo

24、de静态二维码错误非 0成功0返回格式datas: empi: 5D222FCB2058F7726E4EE71A79DFA6F5F474950E9E3C566AAB4F82F60D097842，erhcCardNo: 5D222FCB2058F7726E4EE71A79DFA6F529D0AB739838FF07，qrCode: 5D222FCB2058F7726E4EE71A79DFA6F529D0AB739838FF07:1:1301A0002QTHX0001，returnCode: 0，returnDesc: 请求成功，signString: 8580e1a8b3b3c487696f09

25、110daa0247da7b6695c40eb9f6499d69268853ecd8，timestamp: 1573634817电子健康码个人信息修改（modifyVmcardInfo）接口介绍接口地址:/ip:port/api/do接口方法 接口 POST 方法接口描述修改个人信息中的除身份证和姓名之外的非关键信息接口提供者XX省电子健康码管理平台请求参数名称说明数据类型及长度备注（Y-必填）appId应用唯一识别码AN.36Y 由卡管系统分配timestamp请求时间戳AN.32Y 加密 当前秒数，与标准时间一致nonceStr随机数AN.32Y 小于16位的整数version接口版本号A

26、N.10Y 同文档版本，例V1.0.6method方法名称AN.50Y 不签名modifyVmcardInfoheadSign头部信息签名AN.32Y 不签名详见数据签名方法bodySign上传信息签名AN.32Y 不签名详见数据签名方法signMode数据签名模式AN.32Y 不签名详见数据签名方法encryptMode数据加密模式AN.32Y 不签名详见数据加密方法上传数据erhcCardNo电子健康码IDAN.128Ysex性别AN.2见附录7.5 性别编码（GB2261）nation民族AN.20见附录7.7 民族代码validStartdate证件有效期开始时间AN.8YYYYMMD

27、DvalidEnddate证件有效期结束时间AN.8YYYYMMDDidInst发证机关AN.128birthday出生日期AN.8YYYYMMDDbirthplace出生地AN.128phone本人手机号AN.11不为空时需加密处理，加密linkman联系人姓名AN.50不为空时需加密处理，加密telephone联系人电话AN.11不为空时需加密处理，加密maritalstatuscode婚姻状态AN.2address户籍地址AN.128同身份证地址currentAddress居住地址AN.128现住地址scenePhoto头像照片CLOB转为base64nationality国籍AN.64

28、预留字段，默认中国，可空。language语言AN.32预留字段，默认汉语，可空。appMode操作方式AN.2Y 传输代码1、APP在线申请2、医疗卫生机构自助机申请3、医疗卫生机构窗口申请4、批量预生成5、微信服务号6、微信小程序7、支付宝生活号8、支付宝小程序9、其他orgCode机构唯一识别码AN.36Y由应用机构注册备案过的机构唯一识别码appRecordNo应用备案号AN.17Y由应用注册备案过的应用唯一识别码guardianName监护人姓名AN.50加密guardianIdcode监护人身份证号AN.18加密guardianPhone监护人AN.11加密provinceCode

29、居住省份代码AN.10参照中华人民共和国行政区划代码（GBT2260-2013）（9位区划代码）（V1.1）addressCityCode居住城市代码AN.10参照中华人民共和国行政区划代码（GBT2260-2013）（9位区划代码）（V1.1）countyCode居住县区代码AN.10参照中华人民共和国行政区划代码（GBT2260-2013）（9位区划代码）（V1.1）professionType职业类型AN.3传输代码1.国家机关、党群组织、企、事业单位负责人2.专业技术人员3.办事人员和有关人员4.商业、服务业人员5.农、林、牧、渔、水利业生产人员6.生产、运输设备操作人员及有关人员7.

30、军人8.不便分类的其他从业人员9.无职业见附录职业代码（V1.1）recognizeFlag是否实名认证AN.11如已经实名认证，认证渠道为必传（传输代码）0.尚未实名认证认证渠道：1、微信认证2、银联认证3、 支付宝认证4、 公安认证9、其他认证（V1.1）请求格式method:modifyVmcardInfo，headSign:a7c4b5d2831ea83b45b262e668a703226597a206db66135cb19c7610ea56bc9f，bodySign:b9bd972cc7a3969852af9f8c3ffb1c691f7a16b8b635888f460315bf876

31、0d53a，version:V3.5.0，nonceStr:1234567890，timestamp:60C90F3B796B41878B8D9C393E2B6329，appId:60C90F3B796B41878B8D9C393E2B6329，signMode:SM3，encryptMode:SM4/ECB/ZeroBytePadding，body:birthday:19990215，address:XX省，nation:03，sex:1，validStartdate:20180101，telephone:BFF9B40DE34B51647FC2E4A8B101E590，maritalsta

32、tuscode:10，erhcCardNo:57C81A358BE85D7BC2A2226AC1DB8CC0A048505120BC4AF6，linkman:024FBE02E72692EDCC36E690E8F64CF3，appMode:7，currentAddress:XX自治区XX市XX区，idInst:XX省公安局，validEnddate:20190101，birthplace:XX自治区XX市XX区，phone:BFF9B40DE34B51647FC2E4A8B101E590，orgCode:c7781c38525c40ebbf208cb0afa0c722，appRecordNo:

33、4403A0022APPB0100，scenePhoto:X002，guardianName:A4AA140A396E85860C630A2E1E717794，guardianIdcode:62024480549AF3424EF0AC7AEEF580813D335454A76863308D9CB3C388A8B9F7，guardianPhone:A102DE57F43FCBBAB7E4B191540C5709，professionType:3， provinceCode:150000000， addressCityCode:150300000， countyCode:150303000响应参数

34、属性名称中文名称备注说明returnCode交易结果0 ：成功 非 0：不成功returnDesc对错误或异常的描述信息signString数据签名，签名发放见附录数据签名方法timestamp响应时间戳建议验证datasJson 格式的数据串datas 数据erhcCardNo电子健康码IDempi主索引ID错误非 0成功0返回格式datas: empi: 8C17C18B9F5E95BCEA5A41B4532931833D2892D7441B1EADB8EFB4394BCD756A，erhcCardNo: 3D06CB522786C96739459300C8DED9AB14805A17AB

35、D46B79，returnCode: 0，returnDesc: 请求成功，signString: 4cca1883abd1ea91dde3f6b527c4af83，timestamp: 1572349547电子健康码个人信息查询（getPersonInfo）接口介绍接口地址:/ip:port/api/do接口方法 接口 POST 方法接口描述用于查询持卡人在本系统中的注册信息接口提供者XX省电子健康码管理平台请求参数名称说明数据类型及长度备注（Y-必填）appId应用唯一识别码AN.36Y 由卡管系统分配timestamp请求时间戳AN.32Y、加密当前秒数，与标准时间一致nonceStr随

36、机数AN.32Y 小于16 位的整数version接口版本号AN.10Y档版本号method方法名称AN.50Y 不签名例：getPersonInfoheadSign头部信息签名AN.32Y 不签名详见数据签名方法bodySign上传信息签名AN.32Y 不签名详见数据签名方法signMode数据签名模式AN.32Y 不签名详见数据签名方法encryptMode数据加密模式AN.32Y 不签名详见数据加密方法上传数据（可根据电子健康码 ID 或证件信息（证件类型和证件号码）其一查询）idCardTypeCode证件类别N2Y、见身份证类别代码（V1.1版本增加了类别）idCode证件号码N20

37、Y、加密erhcCardNo电子健康码 IDAN.128YappMode操作方式AN.2Y 传输代码1、APP在线申请2、医疗卫生机构自助机申请3、医疗卫生机构窗口申请4、批量预生成5、微信服务号6、微信小程序7、支付宝生活号8、支付宝小程序9、其他orgCode机构唯一识别码AN.36Y由应用机构注册备案过的机构唯一识别码appRecordNo应用备案号AN.17Y由应用注册备案过的应用唯一识别码请求格式method:getPersonInfo，headSign:42b91e8ae4c9224f626033ed24e3b3b438863798da38f55accfa7e72a03d6920，

38、bodySign:fbd4cddf8c214a71fe452502af87a19271d887b271adfe0f1c7a569078f0b438，version:V3.5.0，appId:60C90F3B796B41878B8D9C393E2B6329，nonceStr:122685614143641657，timestamp:60C90F3B796B41878B8D9C393E2B6329，signMode:SM3，encryptMode:SM4/ECB/ZeroBytePadding，signature: 304502201368C6FF4A228EBFBE22741EBBE71D27D

39、32DBA9E79291E99D03B42E2BC3553FD022100EBF0559D4C40D05651D015C7EE04756C1E999D2727DD86757C3775FFB5762912，body:idCardTypeCode:01，idCode:E61C81386935441E6B12D4A91E3E45DE45FF74432A7141A4381FCCFB21AB9C35，appMode:2，orgCode:KGA00020100000014，appRecordNo:1301A0002QTHX0001响应参数属性名称中文名称备注说明returnCode交易结果0 ：成功 非

40、0：不成功returnDesc对错误或异常的描述信息signString数据签名，签名发放见附录数据签名方法timestamp响应时间戳建议验证datasJson 格式的数据串datas 数据name姓名加密idCode证件号码加密idCardTypeCode证件类别validStartdate身份证有效期开始validEnddate身份证有效期结束idInst发证机关sex性别nation民族birthday出生日期phone本人手机号加密linkman联系人姓名加密telephone联系人电话加密currentAddress居住地址scenePhoto头像照片cardOrgCode发卡机构

41、编码cardOrgName发卡机构名称erhcCardNo电子健康码 IDempi主索引 IDprovinceCode居住省份代码参照中华人民共和国行政区划代码（GBT2260-2013）（9位区划代码）（V1.1）addressCityCode居住城市代码参照中华人民共和国行政区划代码（GBT2260-2013）（9位区划代码）（V1.1）countyCode居住县区代码参照中华人民共和国行政区划代码（GBT2260-2013）（9位区划代码）（V1.1）provinceName居住省份名称参照中华人民共和国行政区划代码（GBT2260-2013）（V1.1）addressCityName居

42、住城市名称参照中华人民共和国行政区划代码（GBT2260-2013）（V1.1）countyName居住县区名称参照中华人民共和国行政区划代码（GBT2260-2013）（V1.1）guardianName监护人姓名加密（数据为空不给返回）（V1.1）guardianIdcode监护人身份证号加密（数据为空不给返回）（V1.1）guardianPhone监护人加密（数据为空不给返回）（V1.1）professionType职业类型加密（数据为空不给返回）（V1.1）错误非 0成功0返回格式 datas: addressCityCode: 150300000， addressCityName:

43、XX市， birthday: 19870803， cardOrgCode: c7781c38525c40ebbf208cb0afa0c722， cardOrgName: XX市中医院， countyCode: 150303000， countyName: XX区， currentAddress: XX自治区XX市XX区， empi: 57C81A358BE85D7BC2A2226AC1DB8CC0FA7D6981ED3DBF6C3B79637687874D05， erhcCardNo: 57C81A358BE85D7BC2A2226AC1DB8CC0A048505120BC4AF6， guar

44、dianIdcode: 62024480549AF3424EF0AC7AEEF580813D335454A76863308D9CB3C388A8B9F7， guardianName: A4AA140A396E85860C630A2E1E717794， guardianPhone: A102DE57F43FCBBAB7E4B191540C5709， idCardTypeCode: 01， idCode: 29D0C959226526F1C20C668F1286FB328ED6C6312504AAA5E8628FEEE834DBB9， idInst: XX省公安局， linkman: 024FBE

45、02E72692EDCC36E690E8F64CF3， name: DC04106CA1E8EABF6F416D024898332F， nation: 03， phone: BFF9B40DE34B51647FC2E4A8B101E590， professionType: 3， provinceCode: 150000000， provinceName: XX自治区， scenePhoto: X002， sex: 1， telephone: BFF9B40DE34B51647FC2E4A8B101E590， validEnddate: 20190101， validStartdate: 201

46、80101 ， returnCode: 0， returnDesc: 请求成功， signString: 0e0f984b5e4ad588380fc91594eaaa7aeeccb7298ab3e53e8330d689c079f36d， timestamp: 1617678493电子健康码二维码获取（getActiveQrCode）接口介绍接口地址:/ip:port/api/do接口方法 接口 POST 方法接口描述上传电子健康码ID获取动态二维码信息接口提供者XX省电子健康码管理平台请求参数名称说明数据类型及长度备注（Y-必填）appId应用唯一识别码AN.36Y 由卡管系统分配timest

47、amp请求时间戳AN.32Y、加密 时间一致nonceStr随机数AN.32Y小于16位整数version接口版本号AN.10Y档版本号method方法名称AN.50Y 不签名 例：getActiveQrCodeheadSign头部信息签名AN.32Y 不签名详见数据签名方法bodySign上传信息签名AN.32Y 不签名详见数据签名方法signMode数据签名模式AN.32Y 不签名详见数据签名方法encryptMode数据加密模式AN.32Y 不签名详见数据加密方法上传数据erhcCardNo电子健康码 IDAN.128Y、appMode操作方式AN.2Y 传输代码1、APP在线申请2、医

48、疗卫生机构自助机申请3、医疗卫生机构窗口申请4、批量预生成5、微信服务号6、微信小程序7、支付宝生活号8、支付宝小程序9、其他orgCode机构唯一识别码AN.36Y由应用机构注册备案过的机构唯一识别码appRecordNo应用备案号AN.17Y由应用注册备案过的应用唯一识别码请求格式method: getActiveQrCode，headSign: a47f0eb4dc289755d9b68df317269d93048d025f3886cb2116c5938a125d3bbb，bodySign: 0df4d2471cead3708fb8f450745e105ad35539e7d26e6e09

49、2adcc359cfaf8a0c，appId: 60C90F3B796B41878B8D9C393E2B6329，version: V3.5.0，nonceStr: 49085533330848874，timestamp: 60C90F3B796B41878B8D9C393E2B6329，signMode: SM3，encryptMode: SM4/ECB/ZeroBytePadding，body: erhcCardNo: 57C81A358BE85D7BC2A2226AC1DB8CC0A048505120BC4AF6，appMode: 9，orgCode:c7781c38525c40ebbf

50、208cb0afa0c722，appRecordNo:4403A0022APPB0100响应参数属性名称中文名称备注说明returnCode交易结果0 ：成功 非 0：不成功returnDesc对错误或异常的描述信息signString数据签名，签名发放见附录数据签名方法timestamp响应时间戳建议验证datasJson 格式的数据串如：datas 数据qrCode动态电子健康码二维码qrCodePicture动态电子健康码二维码图片预留字段，暂不提供name姓名加密idCode证件号码加密sex性别见附录7.5 性别编码（GB2261）nation民族见附录7.7 民族代码idPhoto

51、证件照片BASE64编码错误非 0成功0返回格式datas: idCode: E61C81386935441E6B12D4A91E3E45DE45FF74432A7141A4381FCCFB21AB9C35，idPhoto: ，name: E467EDEC2E69C19C257A7EC44A9732B0，nation: 01，qrCode: 5D222FCB2058F7726E4EE71A79DFA6F529D0AB739838FF07:0:36BDF9B20B5A77014D4D9A7B71900BBA:1301A0002QTHX0001，qrCodePicture: ，sex: 1，ret

52、urnCode: 0，returnDesc: 请求成功，signString: 1343689b1fe1ec77567d67d3e79251303ed13b77ec8a700bd02ad90aca161437，timestamp: 1573636886用码数据上传（batchUploaderhcCardUseInfo）接口介绍接口地址:/ip:port/api/do接口方法 接口 POST 方法接口描述电子健康码管理系统向上级码管平台上传电子健康码使用信息（传递 json 格式数据）接口使用定时批量上传电子健康码的使用信息。100最多上传 100 条。接口提供者电子健康码管理系统（上级系统）主

53、要使用者电子健康码管理系统（下级系统）请求参数名称说明数据类型及长度备注（Y-必填）appId应用唯一识别码AN.36Y 由卡管系统分配timestamp请求时间戳AN.32Y、加密 当前秒数，与标准时间一致nonceStr随机数AN.32Y16version接口版本号AN.10Y同文档版本号如：method方法名称AN.50Y 不签名 例：batchUploaderhcCardUseInfoheadSign请求头部信息数字签名AN.32Y 不签名详见数据签名方法bodySign上传信息数据签名AN.32Y 不签名详见数据签名方法signMode数据签名模式AN.32Y 不签名详见数据签名方法

54、encryptMode数据加密模式AN.32Y 不签名详见数据加密方法电子健康码数据serialNumberId流水号AN.64Y 调用方自定义编码（长度不超过64位，建议使用UUID），在调用方系统内唯一。name姓名AN.32Y、加密idcode身份证号AN.32Y、加密sex性别AN.32参照附录 6.5 性别代码nation民族AN.32Y、见附录6.7 民族代birthday生日D8格式：YYYYMMDDerhcCardNo电子健康码IDAN.128Y、加密orgCode发卡机构唯一识别码AN.32Y由应用机构注册备案过的机构唯一识别码orgName发卡机构名称AN.32YuseOr

55、gCode用卡机构代码AN.32YuseOrgName用卡机构名称AN.32YuseCityCode用卡城市代码AN.32Y和国行政区划代码（GBT2260-2013）useCityName用卡城市名称AN.50Y和国行政区划代码（GBT2260-2013）terminalCode识读终端编码AN.20Y、terminalType刷卡终端类型AN.32Y 参照附录 6.7 刷卡终端类型编码phone电话AN.32不为空时需加密address家庭地址AN.32useTime用卡时间DT15Y 必填 格式：yyyy-MM-dd HH:mm:ssappRecordNo应用备案号AN.17Y 由应用注

56、册备案过的应用唯一识别码medStepCode诊疗环节代码AN.50Y参照附录诊疗环节代码（V1.1细化）medStepName诊疗环节名称AN.128Y参照附录诊疗环节代码（V1.1细化）payAmount支付金额AN.32（V1.1新增，当诊疗环节为010105收费的情况下，必填）payChannel支付渠道AN.3（V1.1新增，当诊疗环节为010105收费的情况下，必填）；参照附录支付渠道编码onlineOrOffline线上或线下AN.2Y1线上，2线下（V1.1新增）请求格式method: batchUploaderhcCardUseInfo，version: V3.5.0，non

57、ceStr: 6258599373，timestamp: A9E34F59E9A906B573899A41DC867D58，headSign: 9148d1873b83bd6b7083963e5fd0faeb9fb3b16729d60bfe7c90c707c097df6a，bodySign: 14899ce8c9633f2d373ad4d52d9e1c1a2ac39626c2438fa5df5d50360c84d102，appId: 60C90F3B796B41878B8D9C393E2B6329，signMode: SM3，encryptMode: SM4/ECB/ZeroBytePaddi

58、ng，body: serialNumberId:92a1fw4444ae，name: 2D81D83A383819E8CAF2DBB40A73ED27，idcode: 02AAA69E75C189309CB6A91CB49FE26FE2688226FE5F3E862302A48BC200FD0E，sex: 1，nation: 03，birthday: 19840111，erhcCardNo: 3F80756E6B7E42D3EE2ED3472A9BB3CDC9C8D68FAB0CDD784069489EDF1A9B5F514DD44E3367DD91B964B109CABF3F62001205

59、31FF55C7142A329A73D76CCC8D，orgCode:c7781c38525c40ebbf208cb0afa0c722，orgName:察右中旗广益隆中心卫生院，useOrgCode: c7781c38525c40ebbf208cb0afa0c722，useOrgName: 察右中旗广益隆中心卫生院，useCityCode: 150200000，useCityName: XX市，terminalCode: 4406A0030080000340088，terminalType:01，phone: B6827FBB77F2493BE2237807CCA1E8F9，address:

60、XX省XX市XX镇，useTime:2021-03-31 14:50:50，appRecordNo:4403A0022APPB0100，medStepCode:010105，medStepName:收费，payAmount:123456.11，payChannel:10000102，onlineOrOffline:1响应参数属性名称中文名称备注说明returnCode交易结果0 ：成功 非 0：不成功returnDesc对错误或异常的描述信息signString数据签名，签名发放见附录数据签名方法datas上传信息描述datas 中的数据结构successCount成功条数failedCoun