DB35-T 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)識(shí)別專利的責(zé)任。本文件由福建省經(jīng)濟(jì)信息中心提出。本文件由福建省信息化標(biāo)準(zhǔn)化技術(shù)委員會(huì)（SAFJ/TC11）歸口。本文件起草單位：福建省經(jīng)濟(jì)信息中心、廈門市行政審批管理局、廈門熙重電子科技有限公司、深圳太極數(shù)智技術(shù)有限公司、福建博思軟件股份有限公司、福建省藥品審核查驗(yàn)中心、福建船政交通職業(yè)學(xué)院。本文件主要起草人：俞希標(biāo)、張瑞、林鈴、王秀云、黃柳鈴、黃條文、張建國、王翔龍、鞏福。DB35/T2086—20221政務(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。DB35/T2086—20223表2接口服務(wù)類目表123456789writewithdrawCarda)打開設(shè)備API,三級類目代碼為open；b)關(guān)閉設(shè)備API,三級類目代碼為close。打開設(shè)備API和關(guān)閉設(shè)備API用于打開/關(guān)閉相應(yīng)的設(shè)備。DB35/T2086—202247接口功能要求7.1證件讀取服務(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的要求。7.2信息獲取服務(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的要求。DB35/T2086—202257.3打印服務(wù)7.3.1獲取普通打印機(jī)狀態(tài)API用于獲取普通打印機(jī)的狀態(tài)信息，返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.13的要求。7.3.2打印文件API用于發(fā)送文件給普通打印機(jī)進(jìn)行打印，并返回打印執(zhí)行結(jié)果信息，請求消息參數(shù)應(yīng)符合附錄A中表A.14的要求,返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.15的要求。7.3.3憑條打印內(nèi)容API用于發(fā)送打印內(nèi)容、打印類型、行間距等信息給憑條打印機(jī)，憑條打印機(jī)根據(jù)信息進(jìn)行打印，請求消息參數(shù)應(yīng)符合附錄A中表A.16的要求。7.3.4切紙API用于發(fā)送切紙方式來觸發(fā)憑條打印機(jī)進(jìn)行切紙，請求消息參數(shù)應(yīng)符合附錄A中表A.17的要求。7.4支付服務(wù)7.4.1讀取銀行卡API用于讀取銀行卡信息，并返回銀行卡號等信息，返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.18的要求。7.4.2退出銀行卡API用于讓銀行讀卡器退出銀行卡。7.4.3讀取按鍵值A(chǔ)PI用于讀取密碼鍵盤的按鍵值，返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.19的要求。7.5圖像服務(wù)7.5.1雙目攝像頭拍照API用于使用雙目攝像頭進(jìn)行拍照，并返回照片信息，返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.20的要求。7.5.2高拍儀拍照API用于使用高拍儀進(jìn)行拍照，并返回照片信息,返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.21的要求。7.5.3人像比對API用于人像照片比對，并返回活體分?jǐn)?shù)、比對結(jié)果等信息，請求消息參數(shù)應(yīng)符合附錄A中表A.22的要求,返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.23的要求。7.5.4圖像裁剪API用于對采集的圖像進(jìn)行裁剪，請求消息參數(shù)應(yīng)符合附錄A中表A.24的要求,返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.25的要求。DB35/T2086—202267.6聲音采集服務(wù)7.6.1開始錄音API用于觸發(fā)拾音器開始錄音，并把錄音文件保存在指定路徑，請求消息參數(shù)應(yīng)符合附錄A中表A.26的要求。7.6.2結(jié)束錄音API用于觸發(fā)拾音器結(jié)束錄音。7.7信息提示服務(wù)7.7.1指示燈狀態(tài)設(shè)置API用于設(shè)置指示燈控設(shè)備的狀態(tài)，請求消息參數(shù)應(yīng)符合附錄A中表A.27的要求。7.7.2人體感應(yīng)傳感器API用于獲取人體感應(yīng)傳感器狀態(tài)，返回是否有人等信息，返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.28的要求。7.7.3溫濕度傳感器API用于獲取溫濕度傳感器的狀態(tài)，返回溫度、濕度等信息，返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.29的要求。7.7.4振動(dòng)傳感器API用于獲取振動(dòng)傳感器的狀態(tài)，返回振動(dòng)強(qiáng)度等信息，返回?cái)?shù)據(jù)集應(yīng)符合附錄A中表A.30的要求。7.7.5開始播放API用于通過揚(yáng)聲器播放指定的提示語，請求消息參數(shù)應(yīng)符合附錄A中表A.31的要求。7.7.6停止播放API用于觸發(fā)揚(yáng)聲器停止播放。7.8其它服務(wù)7.8.1打開軟鍵盤API用于打開軟鍵盤，請求消息參數(shù)應(yīng)符合附錄A中表A.32的要求。7.8.2關(guān)閉軟鍵盤API用于關(guān)閉軟鍵盤。DB35/T2086—20227接口消息參數(shù)各接口請求消息參數(shù)和返回?cái)?shù)據(jù)集見表A.1～表A.32。表A.1讀取居民身份證信息API請求消息參數(shù)11表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—DB35/T2086—20229表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ù)1img1—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密碼鍵盤按鍵識(shí)別碼0123456789表B.5燈控板燈序12346789表B.6軟鍵盤類型DB35/T2086—2022參