DB35T 2086-2022 政務(wù)服務(wù) 自助終端系統(tǒng)接口要求

35Governmentservices—Self-serviceterminalsysteminterfacereIDB35/T2086—2022前言 2規(guī)范性引用文件 3術(shù)語和定義 4縮略語 5總體要求 6接口分類 27接口功能要求 4附錄A（規(guī)范性）接口消息參數(shù) 7附錄B（資料性）數(shù)據(jù)字典 13參考文獻(xiàn) DB35/T2086—2022本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別專利的責(zé)任。本文件由福建省經(jīng)濟(jì)信息中心提出。本文件由福建省信息化標(biāo)準(zhǔn)化技術(shù)委員會（SAFJ/TC11）歸口。本文件起草單位：福建省經(jīng)濟(jì)信息中心、廈門市行政審批管理局、廈門熙重電子科技有限公司、深圳太極數(shù)智技術(shù)有限公司、福建博思軟件股份有限公司、福建省藥品審核查驗(yàn)中心、福建船政交通職業(yè)學(xué)院。本文件主要起草人：俞希標(biāo)、張瑞、林鈴、王秀云、黃柳鈴、黃條文、張建國、王翔龍、鞏福。1DB35/T2086—2022政務(wù)服務(wù)自助終端系統(tǒng)接口要求本文件規(guī)定了政務(wù)服務(wù)自助終端接入各級政府部門政務(wù)服務(wù)應(yīng)用的系統(tǒng)接口的總體要求、接口分類和接口功能要求。本文件適用于政務(wù)服務(wù)自助終端接入各級政府部門政務(wù)服務(wù)應(yīng)用的系統(tǒng)接口開發(fā)、管理工作。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T39735政務(wù)服務(wù)評價(jià)工作指南3術(shù)語和定義GB/T39735界定的以及下列術(shù)語和定義適用于本文件。3.1自助終端self-serviceterminal面向自然人、法人和其他組織提供多部門政務(wù)服務(wù)應(yīng)用的自助辦理設(shè)備。3.2自助終端系統(tǒng)self-serviceterminalsystem安裝在自助終端上，用于接入政務(wù)服務(wù)應(yīng)用的系統(tǒng)。4縮略語下列縮略語適用于本文件。API：應(yīng)用程序編程接口（ApplicationProgrammingInterface）HTTPS：超文本傳輸安全協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer）JSON：JavaScript對象簡普（JavaScriptObjectNotation）MAC：媒體存取控制（MediaAccessControl）REST：表述性狀態(tài)傳遞（RepresentationalStateTransfer）URL：統(tǒng)一資源定位符（UniformResourceLocator）5總體要求5.1數(shù)據(jù)交換方式2DB35/T2086—2022數(shù)據(jù)交換接口應(yīng)以REST架構(gòu)的API接口形式發(fā)布，數(shù)據(jù)交換應(yīng)采用HTTPS協(xié)議進(jìn)行同步通訊，請求方式為POST。5.2數(shù)據(jù)交換消息要求數(shù)據(jù)交換接口消息應(yīng)采用JSON字符串，以鍵值對（key-value）的形式封裝。消息請求及響應(yīng)參數(shù)的英文名為JSON鍵值對的鍵名（key）。消息編碼格式采用UTF-8。5.3請求URL要求每個(gè)數(shù)據(jù)交換接口應(yīng)對應(yīng)一個(gè)唯一的URL：:8801/二級類目代碼/三級類目代碼，通過該URL對接口進(jìn)行訪問。若無特別說明，二級類目代碼和三級類目代碼，應(yīng)符合表2的要求。示例：讀取居民身份證信息API調(diào)用地址：5.4請求消息參數(shù)要求應(yīng)符合如下要求：a)需要提交請求參數(shù)：請求數(shù)據(jù)交換接口的參數(shù)，具體的值應(yīng)符合附錄A的要求，所有參數(shù)組合應(yīng)為JSON，加載到請求體（body）,作為請求提交；b)不需要提交請求參數(shù)：直接通過請求URL進(jìn)行訪問。5.5響應(yīng)消息參數(shù)要求響應(yīng)消息格式應(yīng)為JSON,響應(yīng)消息參數(shù)應(yīng)包含狀態(tài)碼、狀態(tài)信息描述和返回?cái)?shù)據(jù)集。響應(yīng)消息參數(shù)說明見表1。表1響應(yīng)消息參數(shù)說明1235.6接口性能要求應(yīng)符合如下要求：a)自助終端系統(tǒng)接口服務(wù)加載的時(shí)間應(yīng)小于5s；b)接口調(diào)用響應(yīng)時(shí)間應(yīng)小于500ms；c)接口連接超時(shí)時(shí)間設(shè)置不應(yīng)大于2s。6接口分類自助終端系統(tǒng)接口按服務(wù)性質(zhì)劃分為證件讀取服務(wù)、信息獲取服務(wù)、打印服務(wù)、支付服務(wù)、圖像服務(wù)、聲音采集服務(wù)、信息提示服務(wù)和其它服務(wù)。服務(wù)通過相應(yīng)API接口對外提供。接口服務(wù)類目見表2。3DB35/T2086—2022表2接口服務(wù)類目表123456789writewithdrawCarda)打開設(shè)備API,三級類目代碼為open；b)關(guān)閉設(shè)備API,三級類目代碼為close。打開設(shè)備API和關(guān)閉設(shè)備API用于打開/關(guān)閉相應(yīng)的設(shè)備。4DB35/T2086—20227接口功能要求證件讀取服務(wù)7.1.1讀取居民身份證信息API用于讀取居民身份證信息，并返回姓名、證件號碼、出生日期等信息，請求消息參數(shù)應(yīng)符合附錄A中表A.1的要求,返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.2的要求。7.1.2讀取出入境證件信息API用于讀取出入境證件信息，并返回中文姓名、英文姓名、證件號碼等信息，返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.3的要求。信息獲取服務(wù)7.2.1指紋采集API用于執(zhí)行指紋采集的操作，并返回指紋圖片、指紋特征值等信息，返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.4的要求。7.2.2指紋比對API用于通過傳入兩組指紋特征值或指紋圖片進(jìn)行比對，并返回比對分?jǐn)?shù)、比對結(jié)果等信息，請求消息參數(shù)應(yīng)符合附錄A中表A.5的要求,返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.6的要求。7.2.3讀條形碼API用于讀取一維條碼和二維條碼，并返回相應(yīng)的條形碼值，返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.7的要求。7.2.4開始簽名API用于開始記錄簽名信息，并返回簽字屏狀態(tài)、簽名圖片等信息，返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.8的要求。7.2.5結(jié)束簽名API用于結(jié)束簽名，返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.9的要求。7.2.6獲取設(shè)備信息API用于通過事項(xiàng)編碼來獲取設(shè)備信息，可以返回設(shè)備ID、MAC地址等信息，請求消息參數(shù)應(yīng)符合附錄A中表A.10的要求，返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.11的要求。7.2.7獲取設(shè)備硬件能力API用于獲取設(shè)備硬件能力，可以返回設(shè)備支持的硬件能力信息，返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.12的要求。567DB35/T2086—2022接口消息參數(shù)各接口請求消息參數(shù)和返回?cái)?shù)據(jù)集見表A.1～表A.32。表A.1讀取居民身份證信息API請求消息參數(shù)110：否，1：是表A.2讀取居民身份證信息API返回?cái)?shù)據(jù)集1 2—32—4—586—78889—— 表A.3讀取出入境證件信息API返回?cái)?shù)據(jù)集182—3—4—5862—788—8表A.4指紋采集API返回?cái)?shù)據(jù)集1—2——表A.5指紋比對API請求消息參數(shù)1—2—31表A.6指紋比對API返回?cái)?shù)據(jù)集13 21表A.7讀條形碼API返回?cái)?shù)據(jù)集1——表A.8開始簽名API返回?cái)?shù)據(jù)集112—表A.9結(jié)束簽名API返回?cái)?shù)據(jù)集11表A.10獲取設(shè)備信息API請求消息參數(shù)1—9DB35/T2086—2022表A.11獲取設(shè)備信息API返回?cái)?shù)據(jù)集1—2—表A.12獲取設(shè)備硬件能力API返回?cái)?shù)據(jù)集11234516789表A.13獲取普通打印機(jī)狀態(tài)API返回?cái)?shù)據(jù)集12表A.14打印文件API請求消息參數(shù)1是），表A.15打印文件API返回?cái)?shù)據(jù)集11表A.16憑條打印內(nèi)容API請求消息參數(shù)1213343516171810：否，1：是912—3表A.17切紙API請求消息參數(shù)11表A.18讀取銀行卡API返回?cái)?shù)據(jù)集1 表A.19讀取按鍵值A(chǔ)PI返回?cái)?shù)據(jù)集16DB35/T2086—2022表A.20雙目攝像頭拍照API返回?cái)?shù)據(jù)集12—210：否，1：是3—4width3 53—64—表A.21高拍儀拍照API返回?cái)?shù)據(jù)集1—23—3width3—43 表A.22人像比對API請求消息參數(shù)1 2—表A.23人像比對API返回?cái)?shù)據(jù)集13—2—310：否，1：是表A.24圖像裁剪API請求消息參數(shù)112—表A.25圖像裁剪API返回?cái)?shù)據(jù)集1 表A.26開始錄音API請求消息參數(shù)1—表A.27指示燈狀態(tài)設(shè)置API請求消息參數(shù)1221表A.28人體感應(yīng)傳感器API返回?cái)?shù)據(jù)集11表A.29溫濕度傳感器API返回?cái)?shù)據(jù)集14，224，2表A.30振動(dòng)傳感器API返回?cái)?shù)據(jù)集14，2—表A.31開始播放API請求消息參數(shù)1 表A.32打開軟鍵盤API請求消息參數(shù)123—33—DB35/T2086—2022數(shù)據(jù)字典數(shù)據(jù)字典見表B.1～表B.6。表B.1返回狀態(tài)碼01表B.2出入境證件類型表B.3普通打印機(jī)狀態(tài)碼012345678表B.4密碼鍵盤按鍵識別碼0123456789表B.5燈控板燈序12346789表B.6軟鍵盤類型DB35/T2086—2022參考文獻(xiàn)[1]《國務(wù)院辦公廳關(guān)于印發(fā)“互聯(lián)網(wǎng)+政務(wù)服務(wù)”技術(shù)體系建設(shè)指南的通知》（國辦函〔2016〕[2]