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