DB3301T 0366.3-2022 一码通应用规范 第3部分：服务要求

ICS35.040CCSL713301IDB3301/T0366.3—2022前言 2规范性引用文件 3术语和定义 4缩略语 5服务场景 6服务框架 7一码通用户服务要求 28业务应用方服务要求 39接口服务 3附录A（资料性）一码通应用场景 5附录B（规范性）接口调用方式和参数要求 6附录C（规范性）通用接口返回值代码说明 10DB3301/T0366.3—2022本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件是DB3301/T0366《一码通应用规范》的第1部分。DB3301/T0366已经发布了以下部分：——第1部分：通用要求；——第2部分：管理要求；——第3部分：服务要求。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由杭州市数据资源管理局提出、归口并组织实施。本文件起草单位：杭州市余杭区数据资源管理局、杭州余杭大数据经营有限公司。本文件主要起草人：王维忠、高燕、周围、鲍全贵、吴鹏程、董世聪、祝玉婷、何义胜、沈琴琴、林兵、高勇。DB3301/T0366.3—2022“码”作为个人信息的载体，是应用场景中信息互认的有效方式。在不同场景、不同人群、不同平台统一使用码的过程中，需要采集、存储和处理各种数据信息，以实现多种场景应用。目前用于身份识别的二维码五花八门，不同的码制组成和数据格式不一致、数据不共享和互认机制缺乏等问题，给码的集成及应用带来了阻碍：用户在不同场景需切换二维码，操作繁琐使用不便；业务应用方在建设或接入时，不同的码标准在硬件接入过程中要求各异，可能发生业务受阻或重复建设的问题；管理部门无法统一数据获取标准，为数字化管理工作带来困扰。基于以上现状，“一码通”平台通过构建统一的标准，并结合健康码亮码应用，进而逐步搭建覆盖全人群、全场景的码体系。自“一码通”平台开设试点以来，“码”在交通出行、政务服务、医疗健康、文化旅游等多个领域的应用场景中发挥了巨大的作用。因此，从当前的实践情况和长远的应用需求来看，需要实现码的标准一致。DB3301/T0366旨在规定一码通相关应用系统的设计、开发和系统集成方面的要求。三个部分的编制目的如下：——第1部分：通用要求，给出一码通应用规范的管理和服务基本原则和一码通的基本要求；——第2部分：管理要求，给出一码通应用规范的数据管理要求、运维管理要求和安全管理要求；——第3部分：服务要求，给出一码通应用规范的服务场景、服务框架、一码通用户服务要求、业务应用方服务要求和接口服务。1DB3301/T0366.3—2022一码通应用规范第3部分：服务要求本文件规定了一码通应用规范的服务场景、服务框架、一码通用户服务要求、业务应用方服务要求和接口服务。本文件适用于一码通及个人信息相关应用系统的服务标准化管理。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。DB3301/T0366.1一码通应用规范第1部分：通用要求DB3301/T0366.2一码通应用规范第2部分：管理要求3术语和定义DB3301/T0366.1、DB3301/T0366.2界定的以及下列术语和定义适用于本文件。3.1应急码emergencycode在服务器不可用、系统崩溃等紧急情况下可离线使用的二维码。4缩略语下列缩略语适用于本文件。REST：表述性状态转移（RepresentationalStateTransfer）Web：全球广域网（WorldWideWeb）5服务场景一码通用户可通过移动通信终端申领简码，用户可凭码进出多种公共场所，如公园、博物馆、医院等，实现不同场景下的快速核验需求，应用服务场景包括但不限于以下方面：一码出行、一码通办、一码入园、一码入馆、一码就医、一码连心、一码入学、才金直通、三色五益、助残助学、幸福计算器等。具体服务场景说明见附录A。6服务框架26.1一码通应建立信息化服务平台，应具有统一的身份认证、统一电子证照、统一数据交换等公共支务框架见图1。IRSIRS数据3、健康码信息1、浙里办2、支付宝3、市民卡权用户连登生成一码通屏实名信息>一码通入口数据仓库6.2一码通平台基于底层数据库，如互联网数据、物联网数据、公安数据、社保数据、医保数据、市a)用户的身份信息：姓名、手机号码、证件类型、证件号码；b)用户的户籍信息：用户的户籍信息及所在地区的居住信息；c)用户的防疫信息：用户的国家健康码状态信息、用户的新冠疫苗接种状态信息、用户在近期d)用户的类别信息：用户对应人才引进政策的人才级别信息、用户是否7.1服务流程3DB3301/T0366.3—20227.1.3制码通过实名认证与领码操作的用户，可请求生成“一码通信息码”的二维码，并在需要的时候出示此码，作为个人信息证明。主要流程包括：a)用户进行亮码操作时，应用软件通过“二维码调用申请”接口发起业务请求，再调用“个人身份标签”接口，获取个人身份标签信息；b)“个人身份标签”接口根据用户授权内容返回相应的二维码。7.2服务提供7.2.1一码通软件应具有使用端服务功能，解答用户问询和处理用户投诉。7.2.2当遇到系统崩溃、网络阻塞等一码通功能无法正常使用的情况，应通过软件或短信提示等方式及时告知用户。根据实际业务需求，在突发状况下可提供应急码供用户使用。8业务应用方服务要求8.1服务流程8.1.1业务应用方可线上进行使用申请，对使用场景、所需信息进行备案登记，获取二维码使用类型、用户信息。8.1.2平台应遵循统一性和易用性要求，集成通用服务功能，实现个人信息、硬件设备和使用场景的规范统一管理。8.2应用要求8.2.1具体码应用场景由各场景业务应用方负责，一码通主要为不同场景提供便捷化服务，提供综合的大数据分析比对，为各个场景提供码标准和相关数据查询接口服务。8.2.2各场景可通过一码通平台的个人信息，结合场景服务，通过同一个码面向用户服务。8.2.3各场景业务应用方负责所辖场景码服务的投诉处理。8.3对接要求8.3.1已建设码的相关业务应用方，应按照本文件与一码通平台对接。各场景应用软件应能识别由一码通平台生成的简码，实现基于一码通平台简码的互联互通。一码通平台提供跨地区的个人信息查询服务。各业务应用方应在此基础上，结合个人信息数据，进行场景化应用。8.3.2尚未建设码应用的场景，应直接将一码通作为场景码使用，提供特定的服务。9接口服务9.1基本要求一码通系统对外发布服务和接受请求应采用符合REST架构原则的Web服务。9.2服务类型一码通相关的服务类型说明见表1。4DB3301/T0366.3—2022表1服务类型说明1239.3接口管理9.3.1概述接口类型及说明见表2。表2接口类型及说明123459.3.2接口调用方式和参数各类型接口调用方式和参数应符合附录B的规定，接口返回值代码说明应符合附录C的规定。5DB3301/T0366.3—2022（资料性）一码通应用场景应用场景服务说明如下：a)一码出行,以“码”为载体，实现公交、地铁、水上巴士等各类公共交通场景的刷码通用。同时为人才等提供个性化服务，例如刷码免费乘坐指定路线公交；b)一码通办,可在行政服务中心可通过扫码进行预约取号和现场取号；c)一码入园,可通过扫码实名制进入公园游玩；d)一码入馆,可通过扫码实名制进入博物院游玩，同步支持自助图书馆扫码借还图书；e)一码就医,可通过扫码在医院和社区卫生服务中心进行体检预约签到、扫码进行自助基础健康监测、购买应急药品；f)一码连心，搭建市民线上信访快速通道，当市民遇到问题或需要帮助时，可随时随地进行咨询或反映，是市民联系政府的首选通道；g)一码入学，紧贴市民入学需求，市民可精准及时了解教育资源供给，招生入学等政策信息，强化市民对于教育信息的有效获取、教育政策的正确理解、未来需求的准确预期等。h)才金直通，被标记的人才通过扫码或亮码，可实现人才政策“一键兑现”、人才办事“一站入口”、人才双创“一帮到底”、人才服务“一码供给”；i)三色五益，对医疗卫生、食品药品、教育培训、公交客运、养老服务等五大民生公益领域的从业人员通过红、黄、蓝三色赋码管理，市民可进行特定行业从业限制查询；j)助残助学，帮助全教育阶段残疾学生在线申请就学补助，同时也帮助他们解决日常学习和生活中遇到的各类问题；k)幸福计算器，市民可直接检索满足自身资质可享受到的优惠政策，将福利政策直达市民，打通政府与市民之间的最后一公里，提高主动服务和精准服务的力度。6DB3301/T0366.3—2022（规范性）接口调用方式和参数要求B.1产生二维码接口B.1.1调用方式产生二维码接口应通过互联网或政务外网调用。B.1.2参数要求产生二维码接口参数要求见表B.1。表B.1产生二维码接口参数要求是是是是是是是是是是返回数据格式统一采用字符串格式：{"qrcodeBase64":"iVBORw0KGCqYUXU0gxEIwAAAAASUVORK5CYII=","concealCard":"5**************}7DB3301/T0366.3—2022B.2用户标签信息查询接口B.2.1调用方式用户标签信息查询接口应通过互联网或政务外网调用。B.2.2参数要求用户标签信息查询接口参数要求见表B.2。表B.2用户标签信息查询接口参数要求是是是是是是是是返回数据格式统一采用字符串格式：{{"icon":"/yikayima/yhqrcode/202108/cda2a41d10.png",{"icon":"/yikayima/yhqrcode/202108/f7fb8c13e1.png",}]}8DB3301/T0366.3—2022B.3渠道二维码接口B.3.1调用方式渠道二维码接口应通过互联网或政务外网调用。B.3.2参数要求渠道二维码接口参数要求见表B.3。表B.3渠道二维码接口参数要求是是是是是是是是是是是是返回数据格式统一采用字符串格式：{"qrcodeBase64":"iVBORw******"idCard":,"concealCard":"3**************}}B.4解码能力接口B.4.1调用方式解码能力接口应通过互联网或政务外网调用。9DB3301/T0366.3—2022B.4.2参数要求解码能力接口参数要求见表B.4。表B.4解码能力接口参数要求是是是是是是返回数据格式统一采用字符串格式：{"response":"spoafjapioejrqpojrepanvcapfhodshfoaihfdoahvraiohrvquiooifgaaposndapodfsjfiopasncoapsdichpsaojgdioaspjfvian