DB3301T 0366.3-2022 一碼通應(yīng)用規(guī)范 第3部分：服務(wù)要求

ICS35.040CCSL713301IDB3301/T0366.3—2022前言 2規(guī)范性引用文件 3術(shù)語和定義 4縮略語 5服務(wù)場景 6服務(wù)框架 7一碼通用戶服務(wù)要求 28業(yè)務(wù)應(yīng)用方服務(wù)要求 39接口服務(wù) 3附錄A（資料性）一碼通應(yīng)用場景 5附錄B（規(guī)范性）接口調(diào)用方式和參數(shù)要求 6附錄C（規(guī)范性）通用接口返回值代碼說明 10DB3301/T0366.3—2022本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。本文件是DB3301/T0366《一碼通應(yīng)用規(guī)范》的第1部分。DB3301/T0366已經(jīng)發(fā)布了以下部分：——第1部分：通用要求；——第2部分：管理要求；——第3部分：服務(wù)要求。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別專利的責(zé)任。本文件由杭州市數(shù)據(jù)資源管理局提出、歸口并組織實施。本文件起草單位：杭州市余杭區(qū)數(shù)據(jù)資源管理局、杭州余杭大數(shù)據(jù)經(jīng)營有限公司。本文件主要起草人：王維忠、高燕、周圍、鮑全貴、吳鵬程、董世聰、祝玉婷、何義勝、沈琴琴、林兵、高勇。DB3301/T0366.3—2022“碼”作為個人信息的載體，是應(yīng)用場景中信息互認(rèn)的有效方式。在不同場景、不同人群、不同平臺統(tǒng)一使用碼的過程中，需要采集、存儲和處理各種數(shù)據(jù)信息，以實現(xiàn)多種場景應(yīng)用。目前用于身份識別的二維碼五花八門，不同的碼制組成和數(shù)據(jù)格式不一致、數(shù)據(jù)不共享和互認(rèn)機(jī)制缺乏等問題，給碼的集成及應(yīng)用帶來了阻礙：用戶在不同場景需切換二維碼，操作繁瑣使用不便；業(yè)務(wù)應(yīng)用方在建設(shè)或接入時，不同的碼標(biāo)準(zhǔn)在硬件接入過程中要求各異，可能發(fā)生業(yè)務(wù)受阻或重復(fù)建設(shè)的問題；管理部門無法統(tǒng)一數(shù)據(jù)獲取標(biāo)準(zhǔn)，為數(shù)字化管理工作帶來困擾。基于以上現(xiàn)狀，“一碼通”平臺通過構(gòu)建統(tǒng)一的標(biāo)準(zhǔn)，并結(jié)合健康碼亮碼應(yīng)用，進(jìn)而逐步搭建覆蓋全人群、全場景的碼體系。自“一碼通”平臺開設(shè)試點(diǎn)以來，“碼”在交通出行、政務(wù)服務(wù)、醫(yī)療健康、文化旅游等多個領(lǐng)域的應(yīng)用場景中發(fā)揮了巨大的作用。因此，從當(dāng)前的實踐情況和長遠(yuǎn)的應(yīng)用需求來看，需要實現(xiàn)碼的標(biāo)準(zhǔn)一致。DB3301/T0366旨在規(guī)定一碼通相關(guān)應(yīng)用系統(tǒng)的設(shè)計、開發(fā)和系統(tǒng)集成方面的要求。三個部分的編制目的如下：——第1部分：通用要求，給出一碼通應(yīng)用規(guī)范的管理和服務(wù)基本原則和一碼通的基本要求；——第2部分：管理要求，給出一碼通應(yīng)用規(guī)范的數(shù)據(jù)管理要求、運(yùn)維管理要求和安全管理要求；——第3部分：服務(wù)要求，給出一碼通應(yīng)用規(guī)范的服務(wù)場景、服務(wù)框架、一碼通用戶服務(wù)要求、業(yè)務(wù)應(yīng)用方服務(wù)要求和接口服務(wù)。1DB3301/T0366.3—2022一碼通應(yīng)用規(guī)范第3部分：服務(wù)要求本文件規(guī)定了一碼通應(yīng)用規(guī)范的服務(wù)場景、服務(wù)框架、一碼通用戶服務(wù)要求、業(yè)務(wù)應(yīng)用方服務(wù)要求和接口服務(wù)。本文件適用于一碼通及個人信息相關(guān)應(yīng)用系統(tǒng)的服務(wù)標(biāo)準(zhǔn)化管理。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。DB3301/T0366.1一碼通應(yīng)用規(guī)范第1部分：通用要求DB3301/T0366.2一碼通應(yīng)用規(guī)范第2部分：管理要求3術(shù)語和定義DB3301/T0366.1、DB3301/T0366.2界定的以及下列術(shù)語和定義適用于本文件。3.1應(yīng)急碼emergencycode在服務(wù)器不可用、系統(tǒng)崩潰等緊急情況下可離線使用的二維碼。4縮略語下列縮略語適用于本文件。REST：表述性狀態(tài)轉(zhuǎn)移（RepresentationalStateTransfer）Web：全球廣域網(wǎng)（WorldWideWeb）5服務(wù)場景一碼通用戶可通過移動通信終端申領(lǐng)簡碼，用戶可憑碼進(jìn)出多種公共場所，如公園、博物館、醫(yī)院等，實現(xiàn)不同場景下的快速核驗需求，應(yīng)用服務(wù)場景包括但不限于以下方面：一碼出行、一碼通辦、一碼入園、一碼入館、一碼就醫(yī)、一碼連心、一碼入學(xué)、才金直通、三色五益、助殘助學(xué)、幸福計算器等。具體服務(wù)場景說明見附錄A。6服務(wù)框架26.1一碼通應(yīng)建立信息化服務(wù)平臺，應(yīng)具有統(tǒng)一的身份認(rèn)證、統(tǒng)一電子證照、統(tǒng)一數(shù)據(jù)交換等公共支務(wù)框架見圖1。IRSIRS數(shù)據(jù)3、健康碼信息1、浙里辦2、支付寶3、市民卡權(quán)用戶連登生成一碼通屏實名信息>一碼通入口數(shù)據(jù)倉庫6.2一碼通平臺基于底層數(shù)據(jù)庫，如互聯(lián)網(wǎng)數(shù)據(jù)、物聯(lián)網(wǎng)數(shù)據(jù)、公安數(shù)據(jù)、社保數(shù)據(jù)、醫(yī)保數(shù)據(jù)、市a)用戶的身份信息：姓名、手機(jī)號碼、證件類型、證件號碼；b)用戶的戶籍信息：用戶的戶籍信息及所在地區(qū)的居住信息；c)用戶的防疫信息：用戶的國家健康碼狀態(tài)信息、用戶的新冠疫苗接種狀態(tài)信息、用戶在近期d)用戶的類別信息：用戶對應(yīng)人才引進(jìn)政策的人才級別信息、用戶是否7.1服務(wù)流程3DB3301/T0366.3—20227.1.3制碼通過實名認(rèn)證與領(lǐng)碼操作的用戶，可請求生成“一碼通信息碼”的二維碼，并在需要的時候出示此碼，作為個人信息證明。主要流程包括：a)用戶進(jìn)行亮碼操作時，應(yīng)用軟件通過“二維碼調(diào)用申請”接口發(fā)起業(yè)務(wù)請求，再調(diào)用“個人身份標(biāo)簽”接口，獲取個人身份標(biāo)簽信息；b)“個人身份標(biāo)簽”接口根據(jù)用戶授權(quán)內(nèi)容返回相應(yīng)的二維碼。7.2服務(wù)提供7.2.1一碼通軟件應(yīng)具有使用端服務(wù)功能，解答用戶問詢和處理用戶投訴。7.2.2當(dāng)遇到系統(tǒng)崩潰、網(wǎng)絡(luò)阻塞等一碼通功能無法正常使用的情況，應(yīng)通過軟件或短信提示等方式及時告知用戶。根據(jù)實際業(yè)務(wù)需求，在突發(fā)狀況下可提供應(yīng)急碼供用戶使用。8業(yè)務(wù)應(yīng)用方服務(wù)要求8.1服務(wù)流程8.1.1業(yè)務(wù)應(yīng)用方可線上進(jìn)行使用申請，對使用場景、所需信息進(jìn)行備案登記，獲取二維碼使用類型、用戶信息。8.1.2平臺應(yīng)遵循統(tǒng)一性和易用性要求，集成通用服務(wù)功能，實現(xiàn)個人信息、硬件設(shè)備和使用場景的規(guī)范統(tǒng)一管理。8.2應(yīng)用要求8.2.1具體碼應(yīng)用場景由各場景業(yè)務(wù)應(yīng)用方負(fù)責(zé)，一碼通主要為不同場景提供便捷化服務(wù)，提供綜合的大數(shù)據(jù)分析比對，為各個場景提供碼標(biāo)準(zhǔn)和相關(guān)數(shù)據(jù)查詢接口服務(wù)。8.2.2各場景可通過一碼通平臺的個人信息，結(jié)合場景服務(wù)，通過同一個碼面向用戶服務(wù)。8.2.3各場景業(yè)務(wù)應(yīng)用方負(fù)責(zé)所轄場景碼服務(wù)的投訴處理。8.3對接要求8.3.1已建設(shè)碼的相關(guān)業(yè)務(wù)應(yīng)用方，應(yīng)按照本文件與一碼通平臺對接。各場景應(yīng)用軟件應(yīng)能識別由一碼通平臺生成的簡碼，實現(xiàn)基于一碼通平臺簡碼的互聯(lián)互通。一碼通平臺提供跨地區(qū)的個人信息查詢服務(wù)。各業(yè)務(wù)應(yīng)用方應(yīng)在此基礎(chǔ)上，結(jié)合個人信息數(shù)據(jù)，進(jìn)行場景化應(yīng)用。8.3.2尚未建設(shè)碼應(yīng)用的場景，應(yīng)直接將一碼通作為場景碼使用，提供特定的服務(wù)。9接口服務(wù)9.1基本要求一碼通系統(tǒng)對外發(fā)布服務(wù)和接受請求應(yīng)采用符合REST架構(gòu)原則的Web服務(wù)。9.2服務(wù)類型一碼通相關(guān)的服務(wù)類型說明見表1。4DB3301/T0366.3—2022表1服務(wù)類型說明1239.3接口管理9.3.1概述接口類型及說明見表2。表2接口類型及說明123459.3.2接口調(diào)用方式和參數(shù)各類型接口調(diào)用方式和參數(shù)應(yīng)符合附錄B的規(guī)定，接口返回值代碼說明應(yīng)符合附錄C的規(guī)定。5DB3301/T0366.3—2022（資料性）一碼通應(yīng)用場景應(yīng)用場景服務(wù)說明如下：a)一碼出行,以“碼”為載體，實現(xiàn)公交、地鐵、水上巴士等各類公共交通場景的刷碼通用。同時為人才等提供個性化服務(wù)，例如刷碼免費(fèi)乘坐指定路線公交；b)一碼通辦,可在行政服務(wù)中心可通過掃碼進(jìn)行預(yù)約取號和現(xiàn)場取號；c)一碼入園,可通過掃碼實名制進(jìn)入公園游玩；d)一碼入館,可通過掃碼實名制進(jìn)入博物院游玩，同步支持自助圖書館掃碼借還圖書；e)一碼就醫(yī),可通過掃碼在醫(yī)院和社區(qū)衛(wèi)生服務(wù)中心進(jìn)行體檢預(yù)約簽到、掃碼進(jìn)行自助基礎(chǔ)健康監(jiān)測、購買應(yīng)急藥品；f)一碼連心，搭建市民線上信訪快速通道，當(dāng)市民遇到問題或需要幫助時，可隨時隨地進(jìn)行咨詢或反映，是市民聯(lián)系政府的首選通道；g)一碼入學(xué)，緊貼市民入學(xué)需求，市民可精準(zhǔn)及時了解教育資源供給，招生入學(xué)等政策信息，強(qiáng)化市民對于教育信息的有效獲取、教育政策的正確理解、未來需求的準(zhǔn)確預(yù)期等。h)才金直通，被標(biāo)記的人才通過掃碼或亮碼，可實現(xiàn)人才政策“一鍵兌現(xiàn)”、人才辦事“一站入口”、人才雙創(chuàng)“一幫到底”、人才服務(wù)“一碼供給”；i)三色五益，對醫(yī)療衛(wèi)生、食品藥品、教育培訓(xùn)、公交客運(yùn)、養(yǎng)老服務(wù)等五大民生公益領(lǐng)域的從業(yè)人員通過紅、黃、藍(lán)三色賦碼管理，市民可進(jìn)行特定行業(yè)從業(yè)限制查詢；j)助殘助學(xué)，幫助全教育階段殘疾學(xué)生在線申請就學(xué)補(bǔ)助，同時也幫助他們解決日常學(xué)習(xí)和生活中遇到的各類問題；k)幸福計算器，市民可直接檢索滿足自身資質(zhì)可享受到的優(yōu)惠政策，將福利政策直達(dá)市民，打通政府與市民之間的最后一公里，提高主動服務(wù)和精準(zhǔn)服務(wù)的力度。6DB3301/T0366.3—2022（規(guī)范性）接口調(diào)用方式和參數(shù)要求B.1產(chǎn)生二維碼接口B.1.1調(diào)用方式產(chǎn)生二維碼接口應(yīng)通過互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。B.1.2參數(shù)要求產(chǎn)生二維碼接口參數(shù)要求見表B.1。表B.1產(chǎn)生二維碼接口參數(shù)要求是是是是是是是是是是返回數(shù)據(jù)格式統(tǒng)一采用字符串格式：{"qrcodeBase64":"iVBORw0KGCqYUXU0gxEIwAAAAASUVORK5CYII=","concealCard":"5**************}7DB3301/T0366.3—2022B.2用戶標(biāo)簽信息查詢接口B.2.1調(diào)用方式用戶標(biāo)簽信息查詢接口應(yīng)通過互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。B.2.2參數(shù)要求用戶標(biāo)簽信息查詢接口參數(shù)要求見表B.2。表B.2用戶標(biāo)簽信息查詢接口參數(shù)要求是是是是是是是是返回數(shù)據(jù)格式統(tǒng)一采用字符串格式：{{"icon":"/yikayima/yhqrcode/202108/cda2a41d10.png",{"icon":"/yikayima/yhqrcode/202108/f7fb8c13e1.png",}]}8DB3301/T0366.3—2022B.3渠道二維碼接口B.3.1調(diào)用方式渠道二維碼接口應(yīng)通過互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。B.3.2參數(shù)要求渠道二維碼接口參數(shù)要求見表B.3。表B.3渠道二維碼接口參數(shù)要求是是是是是是是是是是是是返回數(shù)據(jù)格式統(tǒng)一采用字符串格式：{"qrcodeBase64":"iVBORw******"idCard":,"concealCard":"3**************}}B.4解碼能力接口B.4.1調(diào)用方式解碼能力接口應(yīng)通過互聯(lián)網(wǎng)或政務(wù)外網(wǎng)調(diào)用。9DB3301/T0366.3—2022B.4.2參數(shù)要求解碼能力接口參數(shù)要求見表B.4。表B.4解碼能力接口參數(shù)要求是是是是是是返回數(shù)據(jù)格式統(tǒng)一采用字符串格式：{"response":"spoafjapioejrqpojrepanvcapfhodshfoaihfdoahvraiohrvquiooifgaaposndapodfsjfiopasncoapsdichpsaojgdioaspjfvian