DB32T 3761.46-2021新型冠状病毒肺炎疫情防控技术规范 第46部分：苏康码服务接口

江苏省市场监督管理局发布ICS13.100江苏省地DB32方标准DB2/T3761.46—2021规范TechnicalspecificationsforCOVID19preventionandcontrolPart:SKMserviceinterface 前言TDBT。江苏省卫生健康委员会提出。。新型冠状病毒肺炎疫情防控技术规范、接口说明和接口应用。设计、开发和系统集成。S性引用文件，GBT9信息安全技术网络安全等级保护基本要求；GBT6GBT0GBT3GB/T35274定义个人信息personalinformation以电子或者其他方式记录的能够单独或者与其他信息结合识别特定自然人身份或者反映特定自然物识别信息、住址、通信通讯联系方式、通信记录和内交易信息等。息。onsent的行为。意consent信息主体对其个人信息进行特定处理作出明确授权的行为。[GB/T35273-2020,定义3.7]personalhealthinformationcodeofJiangsu;SKM常rvice通过身份认证的用户提供生产、验证苏康码或其对应二维条码的服务。singlesignonSSOJIS用系统。。et于系统间的授权互信，第三方应用可以通过校验该凭证获得授权令牌(token)，票据只能使用一次且token于系统间的授权互信，第三方应用可以通过校验该凭证获得授权令牌(token)，票据只能使用一次且ark一身份认证接口时，应用标识作为参数传入。ppwordMD4缩略语。H超文本传输协议5(HyperTextTransferProtocol5)HTTPS:超文本传输安全协议(HyperTextTransferProtocoloverSecureSocketLayer)JSON：轻量级的数据交换格式(JavaScriptObjectNotation)REST：表述性状态转移(RepresentationalStateTranser)Web：全球广域网(WorldWideWeb)UUID：通用唯一识别码(UniversallyUniqueIdentifier)接口规则5.1接口方式受请求应采用符合REST架构原则的Web服务；发布苏康码亮码接口应采用符合H5协5.2接口类型及说明见说明见表1及说明1用户令牌接口生成用户令牌234口详情1江苏政务服务生成用户令牌接口接口描述同时实现生成用户令牌(token)和UUID，将令牌和UUID传递到苏康码H5页面实现苏康码应用单点登业务流程a经用户明示同意或授权同意后将本端用户个人信息资料调用省平台：生成用户令牌接口。ctokenUUID信息等。接入要求a户在出示苏康码时必须是实名用户。b用户的实名信息必须与省政务服务平台统一用户一致。调用方式务服务生成用户令牌接口应通过互联网或电子政务外网调用。参数说明务生成用户令牌接口参数说明见附录A苏康码亮码接口接口描述该接口实现接收江苏政务服务生成用户令牌接口生成的令牌和UUID后返回用户苏康码展示H5页面业务流程接入要求江苏政务服务生成用户令牌接口生成有效的令牌调用方式过互联网参数说明数要求见表2码接口参数要求ken是uuid否苏康码扫码核验接口接口描述接收用户苏康码二维条码信息后返回用户健康状态功能业务流程a户授权同意后获取用户苏康码二维条码信息。b)将用户苏康码二维条码信息和其他参数传入苏康码扫码核验接口。c接入要求a授权同意。c途。调用方式参数说明口参数说明见附录B苏康码证件号码核验接口接口描述业务流程a户明示同意、授权同意后获取用户个人信息。b将用户个人信息和其他参数传入苏康码扫码核验接口。c息。接入要求a示同意、授权同意。c途。调用方式参数说明验接口参数说明见附录C对接模式.1各设区市防疫指挥部门指定的健康码建设运行单位可申请江苏政务服务生成用户令牌接口、苏核验工作。1.3防疫重点场所可向拥有二封授权的所属设区市的健康码建设运行单位、所属行业的省级政务主码核验接口。安全要求求。.2申请苏康码扫码核验接口、苏康码证件号码核验接口的应用系统在采集、加工、利用个人信息.3申请使用苏康码扫码核验接口、苏康码证件号码核验接口的应用系统在利用个人信息时应获取示同意或授权同意，并承诺对相关隐私内容进行保密。A(规范性附录)务服务生成用户令牌接口参数说明A.1参数要求A政务服务生成用户令牌接口参数要求是me是时分秒是emee是业务名称(固定值:"createToken")params是aperstypepapersnumber98703452345",emailzhangsancomretcode是g是否{tcodetokenaff9db301db4035d2382123f8d5d25ae290a5b0dcd3af221aa2bcbb770e",uuidP5123412334567821"}}(2)失败响应{retcodemsg空"}A.2params参数params参数要求见表A.2表A.2params参数要求ame55是perstype55是证件类型(默认为1)证papersnumber是bile55是55否phone55否否1否s55否post55否A.3返回状态码表A.3A码01认证失败，必填参数为空(精确到具体哪个参数为空)23标识不正确4密钥不正确5应用不存在0120常空2误3误4识已被禁用907查询到企业8查询到对应企业已失效已过期据不存在或已过期0001已过期0002已失效00030004生成失败0005名未被激活0006名或密码不正确0007令牌0008未申请登录名(或其他必填项)不能为空正确正确正确错误A.4data参数data见表A.4表A.4data参数说明ken55否uuid55否一识别码(规范性附录)接口参数说明B数要求苏康码扫码核验接口参数要求见表B.1B码核验接口参数要求url是来的苏康码二维条码内容是识申请单位(例如：nanjing,wuxi,suzhou)position是fierDept是核验人部门(例如：江苏省疾控中心)ifierName是核验人名称(例如：王XX)verifierPhone是1509999xxxx)ken是esCode是sMessage是s是{sageOKresCode0,"res":{createTime610731,detip常通风、戴口罩，出现发热咳嗽等症状请及时就医",phone00',idcardNo*******0000"}}(2)失败响应{sMessage}B应状态码B码01其他异常失效不是苏康码提示会具体到参数名resres参数说明见表B.3表B.3res参数表ame55否55否否ip55否phone55否dNo55否(规范性附录)码核验接口参数说明C参数要求苏康码证件号码核验接口参数要求见表C.1C证件号码核验接口参数要求是body是me}body是essage}{code":200,ssage{userid********9219",mevelDataexceptionCodeReason定"}}(2)失败响应{code":407,message",}body要求见表C.2userid55是ame55是ti55否55否C应体body参数bodyC33是sage55是述1024是C响应状态码C码00000307C请求结果data参数data参数说明见表C.5Cdata明userid55是ame55是1是tionCodeon55是(规范性附录)码核验接口加解密方法使用说明D鉴加密D接口方提供权鉴参数和权鉴加密