DB32T 3761.46-2021 新型冠狀病毒肺炎疫情防控技術(shù)規(guī)范 第46部分：蘇康碼服務(wù)接口　　

DB32TechnicalspecificationsforCOVID-2019preventionand江蘇省市場(chǎng)監(jiān)督管理局發(fā)布I 2 2 2 3 3 4 6 7 本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定本文件主要起草人：周玉平、梁皓、高菲、劉瀟、陳敘堯、朱寶立、管榮黎、馬佳、石鐵1新型冠狀病毒肺炎疫情防控技術(shù)規(guī)范第46部分："蘇康碼"服務(wù)接口以電子或者其他方式記錄的能夠單獨(dú)或者與其他信息結(jié)合識(shí)別特定自然人身份或者反映特定自然注1：個(gè)人信息包括姓名、出生日期、身份證件號(hào)碼注2：個(gè)人信息控制者通過(guò)個(gè)人信息或其他信息加2個(gè)人信息主體對(duì)其個(gè)人信息進(jìn)行特定處理作出明確授權(quán)的蘇康碼personalhealthinformationcodeofJiangsu;SKM于系統(tǒng)間的授權(quán)互信，第三方應(yīng)用可以通過(guò)校驗(yàn)該憑證獲得授權(quán)令牌（token），票據(jù)只能使用一次且于系統(tǒng)間的授權(quán)互信，第三方應(yīng)用可以通過(guò)校驗(yàn)該憑證獲得授權(quán)令牌（token），票據(jù)只能使用一次且系統(tǒng)在調(diào)用統(tǒng)一身份認(rèn)證接口時(shí)，應(yīng)用標(biāo)識(shí)3證接口服務(wù)時(shí)，應(yīng)用標(biāo)識(shí)、應(yīng)用密鑰和當(dāng)前時(shí)間戳按照4縮略語(yǔ)H5：超文本傳輸協(xié)議5（HyperTextTransferProtocolHTTPS:超文本傳輸安全協(xié)議（HyperTextTransferProtocoloverJSON：輕量級(jí)的數(shù)據(jù)交換格式（JavaScriptObjectNotaREST：表述性狀態(tài)轉(zhuǎn)移（RepresentationaWeb：全球廣域網(wǎng)（WorldWideWeb）5.1接口方式核驗(yàn)接口服務(wù)和接受請(qǐng)求應(yīng)采用符合REST架構(gòu)原則的Web服務(wù)；發(fā)布蘇康碼亮碼接5.2接口類型1234同時(shí)實(shí)現(xiàn)生成用戶令牌（token）和UUID，將令牌和UUID傳遞到蘇康碼H5頁(yè)面實(shí)現(xiàn)蘇康碼應(yīng)用單點(diǎn)登4a)經(jīng)用戶明示同意或授權(quán)同意后將本端用戶個(gè)人信息資料調(diào)用省平臺(tái)：生成用戶令牌接b)省平臺(tái)確認(rèn)用戶是否已經(jīng)存在，如未存在進(jìn)行快捷資料創(chuàng)建。b)用戶的實(shí)名信息必須與省政務(wù)服務(wù)平臺(tái)統(tǒng)一用戶一該接口實(shí)現(xiàn)接收江蘇政務(wù)服務(wù)生成用戶令牌接口生成的令牌和UUID后返回用戶蘇康碼展示H5頁(yè)面a)將token和用戶UUID通過(guò)蘇康碼H5進(jìn)行信息傳遞。應(yīng)接入江蘇政務(wù)服務(wù)生成用戶令牌接口生成有5是uuid否該接口實(shí)現(xiàn)接收用戶蘇康碼二維條碼信息后返回用戶a)經(jīng)用戶授權(quán)同意后獲取用戶蘇康碼二b)將用戶蘇康碼二維條碼信息和其他參數(shù)傳入蘇康碼掃碼核驗(yàn)接口。a)經(jīng)用戶明示同意、授權(quán)同意后獲取用b)將用戶個(gè)人信息和其他參數(shù)傳入蘇康碼掃碼核驗(yàn)接67.1.1各設(shè)區(qū)市防疫指揮部門指定的健康碼建設(shè)運(yùn)行單位可申請(qǐng)江蘇政務(wù)服務(wù)生成用戶令牌康碼亮碼接口，在原有系統(tǒng)中集成蘇康碼應(yīng)用，原則上每個(gè)設(shè)區(qū)市僅允許一家建設(shè)運(yùn)行單位對(duì)接。7.1.3防疫重點(diǎn)場(chǎng)所可向擁有二封授權(quán)的所屬設(shè)區(qū)市的健康碼建設(shè)運(yùn)行單位、所屬行業(yè)的省7.2.1申請(qǐng)江蘇政務(wù)服務(wù)生成用戶令牌接口、蘇康碼亮碼接口的應(yīng)用系統(tǒng)應(yīng)達(dá)到G7.2.2申請(qǐng)?zhí)K康碼掃碼核驗(yàn)接口、蘇康碼證件號(hào)碼核驗(yàn)接口的應(yīng)用系統(tǒng)在采集、加工、利用7.2.3申請(qǐng)使用蘇康碼掃碼核驗(yàn)接口、蘇康碼證件號(hào)碼核驗(yàn)接口的應(yīng)用系統(tǒng)在利用個(gè)人信息用戶的明示同意或授權(quán)同意，并承諾對(duì)相關(guān)隱私內(nèi)容7.2.4申請(qǐng)使用蘇康碼掃碼核驗(yàn)接口、蘇康碼證件號(hào)碼核驗(yàn)接口的應(yīng)用系統(tǒng)應(yīng)遵循GB/7A.1參數(shù)要求是是是參數(shù)內(nèi)容為：MD5(appmark+ap是params是"papersnumber":"32133419retcode是是否示例1）成功響應(yīng){8"token":"1af90f979db301db4035d2382123f8d5d25ae290a5b0dcd3af221aa2"uuid":"P20200505123412334567821"}}{}A.2params參數(shù)params參數(shù)要求見(jiàn)表A.2是是papersnumber是是否phone否否1否否post否A.3返回狀態(tài)碼9A.4data參數(shù)表A.4data參數(shù)說(shuō)明否uuid否url是是來(lái)源，用于標(biāo)識(shí)申請(qǐng)單位（例如：nanjing,wuxi,position是是是verifierPhone是是是是是示例1）成功響應(yīng){"tip":"綠色：勤洗手、常通風(fēng)、戴口罩，出現(xiàn)發(fā)}}{}01res參數(shù)說(shuō)明見(jiàn)表B.3否否否否phone否否是），body是請(qǐng)求體，業(yè)務(wù)參數(shù)，JSON格式。數(shù)據(jù)固定格式如下:}注意：body參數(shù)需要加密后以texbody是}示例1）成功響應(yīng){{}}{}userid是是否否3是是是userid是是1是是D.1.3權(quán)鑒參數(shù)加密結(jié)果填到“auth”字段中在HTTP請(qǐng)求h