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

福建省市場監(jiān)督管理局發(fā)布ICS01.040.35CCSL72福建省地35方標(biāo)準(zhǔn)DBT022要求vernmentservicesSelfserviceterminalsysteminterfacerequirementsIDB35/T2086—2022 性引用文件 1 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è)學(xué)院。本文件主要起草人：俞希標(biāo)、張瑞、林鈴、王秀云、黃柳鈴、黃條文、張建國、王翔龍、鞏福。1DB35/T2086—2022政務(wù)服務(wù)自助終端系統(tǒng)接口要求1范圍本文件規(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ù)評價工作指南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。每個數(shù)據(jù)交換接口應(yīng)對應(yīng)一個唯一的URL：:8801/二級類目代碼/三級類目代碼，通過該URL對接口進(jìn)行訪問。若無特別說明，二級類目代碼和三級類目代碼，應(yīng)符合表2的要求。示例：讀取居民身份證信息API調(diào)用地址：:8801/idcardManage/read5.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)信息描述和返回數(shù)據(jù)集。響應(yīng)消息參數(shù)說明見表1。表1響應(yīng)消息參數(shù)說明序號參數(shù)參數(shù)名稱類型類型名稱參數(shù)說明1code狀態(tài)碼t整型詳見附錄B中的表B.12msg狀態(tài)信息描述String字符串返回情況描述信息3data返回數(shù)據(jù)集Object對象返回的數(shù)據(jù)結(jié)果集，采用JSON字符串表示；若需要返回數(shù)據(jù)集，應(yīng)符合附錄A的要求5.6接口性能要求應(yīng)符合如下要求：a)自助終端系統(tǒng)接口服務(wù)加載的時間應(yīng)小于5s；b)接口調(diào)用響應(yīng)時間應(yīng)小于500ms；c)接口連接超時時間設(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ù)類目表1信息API2age信息API3agent4teFingerPrInt5eAPI6I78geI9APItytManagePItFileptPrintManagewriteItCutpaperkCardManangeIwithdrawCardPIameraManagePIographManageoGraphupManageIIySensorPIditySensorIionSensorIIardManage：a)打開設(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的要求,返回數(shù)據(jù)集應(yīng)符合附錄A中表A.2的要求。7.1.2讀取出入境證件信息API用于讀取出入境證件信息，并返回中文姓名、英文姓名、證件號碼等信息，返回數(shù)據(jù)集應(yīng)符合附錄A中表A.3的要求。信息獲取服務(wù)7.2.1指紋采集API用于執(zhí)行指紋采集的操作，并返回指紋圖片、指紋特征值等信息，返回數(shù)據(jù)集應(yīng)符合附錄A中表A.4的要求。7.2.2指紋比對API用于通過傳入兩組指紋特征值或指紋圖片進(jìn)行比對，并返回比對分?jǐn)?shù)、比對結(jié)果等信息，請求消息參數(shù)應(yīng)符合附錄A中表A.5的要求,返回數(shù)據(jù)集應(yīng)符合附錄A中表A.6的要求。7.2.3讀條形碼API用于讀取一維條碼和二維條碼，并返回相應(yīng)的條形碼值，返回數(shù)據(jù)集應(yīng)符合附錄A中表A.7的要求。7.2.4開始簽名API用于開始記錄簽名信息，并返回簽字屏狀態(tài)、簽名圖片等信息，返回數(shù)據(jù)集應(yīng)符合附錄A中表A.8的要求。7.2.5結(jié)束簽名API用于結(jié)束簽名，返回數(shù)據(jù)集應(yīng)符合附錄A中表A.9的要求。7.2.6獲取設(shè)備信息API用于通過事項編碼來獲取設(shè)備信息，可以返回設(shè)備ID、MAC地址等信息，請求消息參數(shù)應(yīng)符合附錄A中表A.10的要求，返回數(shù)據(jù)集應(yīng)符合附錄A中表A.11的要求。7.2.7獲取設(shè)備硬件能力API用于獲取設(shè)備硬件能力，可以返回設(shè)備支持的硬件能力信息，返回數(shù)據(jù)集應(yīng)符合附錄A中表A.12的要求。5DB35/T2086—2022打印服務(wù)7.3.1獲取普通打印機(jī)狀態(tài)API用于獲取普通打印機(jī)的狀態(tài)信息，返回數(shù)據(jù)集應(yīng)符合附錄A中表A.13的要求。7.3.2打印文件API用于發(fā)送文件給普通打印機(jī)進(jìn)行打印，并返回打印執(zhí)行結(jié)果信息，請求消息參數(shù)應(yīng)符合附錄A中表A.14的要求,返回數(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的要求。支付服務(wù)7.4.1讀取銀行卡API用于讀取銀行卡信息，并返回銀行卡號等信息，返回數(shù)據(jù)集應(yīng)符合附錄A中表A.18的要求。7.4.2退出銀行卡API用于讓銀行讀卡器退出銀行卡。7.4.3讀取按鍵值A(chǔ)PI用于讀取密碼鍵盤的按鍵值，返回數(shù)據(jù)集應(yīng)符合附錄A中表A.19的要求。圖像服務(wù)7.5.1雙目攝像頭拍照API用于使用雙目攝像頭進(jìn)行拍照，并返回照片信息，返回數(shù)據(jù)集應(yīng)符合附錄A中表A.20的要求。7.5.2高拍儀拍照API用于使用高拍儀進(jìn)行拍照，并返回照片信息,返回數(shù)據(jù)集應(yīng)符合附錄A中表A.21的要求。7.5.3人像比對API用于人像照片比對，并返回活體分?jǐn)?shù)、比對結(jié)果等信息，請求消息參數(shù)應(yīng)符合附錄A中表A.22的要求,返回數(shù)據(jù)集應(yīng)符合附錄A中表A.23的要求。7.5.4圖像裁剪API用于對采集的圖像進(jìn)行裁剪，請求消息參數(shù)應(yīng)符合附錄A中表A.24的要求,返回數(shù)據(jù)集應(yīng)符合附錄A中表A.25的要求。6DB35/T2086—2022聲音采集服務(wù)7.6.1開始錄音API用于觸發(fā)拾音器開始錄音，并把錄音文件保存在指定路徑，請求消息參數(shù)應(yīng)符合附錄A中表A.26的要求。7.6.2結(jié)束錄音API用于觸發(fā)拾音器結(jié)束錄音。信息提示服務(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)，返回是否有人等信息，返回數(shù)據(jù)集應(yīng)符合附錄A中表A.28的要求。7.7.3溫濕度傳感器API用于獲取溫濕度傳感器的狀態(tài)，返回溫度、濕度等信息，返回數(shù)據(jù)集應(yīng)符合附錄A中表A.29的要求。7.7.4振動傳感器API用于獲取振動傳感器的狀態(tài)，返回振動強(qiáng)度等信息，返回數(shù)據(jù)集應(yīng)符合附錄A中表A.30的要求。7.7.5開始播放API用于通過揚聲器播放指定的提示語，請求消息參數(shù)應(yīng)符合附錄A中表A.31的要求。7.7.6停止播放API用于觸發(fā)揚聲器停止播放。其它服務(wù)7.8.1打開軟鍵盤API用于打開軟鍵盤，請求消息參數(shù)應(yīng)符合附錄A中表A.32的要求。7.8.2關(guān)閉軟鍵盤API用于關(guān)閉軟鍵盤。7DB35/T2086—2022附錄A(規(guī)范性)接口消息參數(shù)各接口請求消息參數(shù)和返回數(shù)據(jù)集見表A.1~表A.32。表A.1讀取居民身份證信息API請求消息參數(shù)序號參數(shù)參數(shù)名稱類型長度備注1finger是否獲取指紋t10：否，1：是表A.2讀取居民身份證信息API返回數(shù)據(jù)集序號參數(shù)參數(shù)名稱類型長度備注1name姓名String50—2nationString40—3sex性別String2—4docNo證件號碼String—5birth出生日期String8日期格式：YYYYMMDD6address戶籍地址String—7startDate有效起始時間String8日期格式：YYYYMMDD8endDate有效截止時間String8日期格式：YYYYMMDD9regOffice簽發(fā)機(jī)關(guān)String—photo頭像圖片String—base64字符串fingerImg指紋圖片String—base64字符串表A.3讀取出入境證件信息API返回數(shù)據(jù)集序號參數(shù)參數(shù)名稱類型長度備注1docType證件類型String8詳見附錄B中的表B.22docNo證件號碼String—3chiName中文姓名String0—4engName英文姓名String0—5birth出生日期String8日期格式：YYYYMMDD6sex性別String2—7expire有效期String8日期格式：YYYYMMDD8photo照片base64字符串String—base64字符串8DB35/T2086—2022序號參數(shù)參數(shù)名稱類型長度備注1imgData指紋圖片字符串String—base64字符串2features指紋特征字符串String——AAPI消息參數(shù)序號參數(shù)參數(shù)名稱類型長度備注1fingerData1待比對的指紋數(shù)據(jù)1String—特征值字符串或指紋圖片base64字符串，具體依據(jù)type值來定2fingerData2待比對的指紋數(shù)據(jù)2String—3type比對類型t10：特征值比對，1：圖片比對序號參數(shù)參數(shù)名稱類型長度備注1score比對分?jǐn)?shù)t3—2result比對結(jié)果t10：同一人，1：非同一人序號參數(shù)參數(shù)名稱類型長度備注1result掃描內(nèi)容String——序號參數(shù)參數(shù)名稱類型長度備注1result簽字屏狀態(tài)t11：正在簽名，2：簽名結(jié)束，3：用戶取消簽名2image簽名圖片String—base64字符串序號參數(shù)參數(shù)名稱類型長度備注1result操作結(jié)果t10：成功，其它：失敗表A.10獲取設(shè)備信息API請求消息參數(shù)序號參數(shù)參數(shù)名稱類型長度備注1moduleCode事項編碼String40—9DB35/T2086—2022表A.11獲取設(shè)備信息API返回數(shù)據(jù)集序號參數(shù)參數(shù)名稱類型長度備注1deviceId設(shè)備idString—2macAddress設(shè)備mac地址String—表A.12獲取設(shè)備硬件能力API返回數(shù)據(jù)集序號參數(shù)參數(shù)名稱類型長度備注1readIdCard讀取居民身份證信息t10：不支持，1：支持2readCrjCard讀取出入境證件信息3fingerprInt指紋采集4validateFingerPrInt指紋比對5readErCode讀取條形碼t10：不支持，1：支持6sign簽字7printFile打印文件8receiptPrint打印憑條9printCutpaper憑條切紙readBankCard讀取銀行卡eppManage密碼鍵盤livingBodyDetect雙目攝像頭拍照faceComp人像比對smartCutOut圖像裁剪photoGraph高拍儀拍照pickupManage錄音ledManage指示燈bodySensor人體感應(yīng)傳感器tempAndHumiditySensor溫濕度傳感器0vibrationSensor振動傳感器1ttsManage語音提示2keyboard軟鍵盤表A.13獲取普通打印機(jī)狀態(tài)API返回數(shù)據(jù)集序號參數(shù)參數(shù)名稱類型長度備注1status打印機(jī)狀態(tài)碼t2詳見附錄B中的表B.3DB35/T2086—2022A印文件API請求消息參數(shù)序號參數(shù)參數(shù)名稱類型長度備注1path打印文件絕對路徑String是文件名(全路徑)，如C:/file.pdf，或者為文件下載URL(以http開頭)AAPI集序號參數(shù)參數(shù)名稱類型長度備注1result執(zhí)行結(jié)果t10：正常，1：失敗表A.16憑條打印內(nèi)容API請求消息參數(shù)序號參數(shù)參數(shù)名稱類型長度備注1content打印內(nèi)容String500非空項2type打印類型t1非空項；0：字符串，1：一維條形碼，2：二維碼3lineSpace行間距t3取值0-127，單位0.125mm4space字符間距t3取值0-127，單位0.125mm5size字體大小t1取值1-86qrSize二維碼打印大小t1取值1-4，默認(rèn)47alignment水平對齊方式t10：左對齊，1：居中，2：右對齊8bold是否加粗t10：否，1：是9underline下劃線t10：無，1：一個點，2：兩個點line走紙行數(shù)t2—leftmargin左邊距t3取值0-576，單位0.125mm序號參數(shù)參數(shù)名稱類型長度備注1prIntCutpaper切紙方式t1默認(rèn)為0，0：全切，1：半切A讀取銀行卡API返回數(shù)據(jù)集序號參數(shù)參數(shù)名稱類型長度備注1cardNum銀行卡卡號String—A讀取按鍵值A(chǔ)PI返回數(shù)據(jù)集序號參數(shù)參數(shù)名稱類型長度備注1keyValue按鍵識別碼String6詳見附錄B中的表B.4DB35/T2086—2022表A.20雙目攝像頭拍照API返回數(shù)據(jù)集序號參數(shù)參數(shù)名稱類型長度備注1score活體分?jǐn)?shù)t2—2result是否為活體t10：否，1：是3livePhoto活體圖像String—base64字符串4width寬度t3—5height高度t3—6dpi分辨率t4—A拍儀拍照API返回數(shù)據(jù)集序號參數(shù)參數(shù)名稱類型長度備注1imgDataString—base64字符串2dpi分辨率t3—3width寬度t3—4height高度t3—A對API請求消息參數(shù)序號參數(shù)參數(shù)名稱類型長度備注1img待比對人像圖片1String—base64字符串2img待比對人像圖片2String—base64字符串AAPI集序號參數(shù)參數(shù)名稱類型長度備注1score活體分?jǐn)?shù)t3—2similarity相似度Float5，2—3result是否為同一人t10：否，1：是A剪API請求消息參數(shù)序號參數(shù)參數(shù)名稱類型長度備注1imgType圖像類型t10：A4紙，1：卡證類，2：其他2imgData輸入圖像String—base64字符串AAPI集序號參數(shù)參數(shù)名稱類型長度備注1imgData輸出圖像String—base64字符串DB35/T2086—2022A始錄音API請求消息參數(shù)序號參數(shù)參數(shù)名稱類型長度備注1filename錄音文件存放路徑String200—表A.27指示燈狀態(tài)設(shè)置API請求消息參數(shù)序號參數(shù)參數(shù)名稱類型長度備注1moduleId燈控板燈序t2詳見附錄B中的表B.52status狀態(tài)t10：關(guān)閉，1：常亮，2：閃爍表A.28人體感應(yīng)傳感器API返回數(shù)據(jù)集序號參數(shù)參數(shù)名稱類型長度備注1status是否有人t10：有人，1：無人表A.29溫濕度傳感器API返回數(shù)據(jù)集序號參數(shù)參數(shù)名稱類型長度備注1temperature溫度Float4，2單位攝氏度2humidity濕度Float4，2百分比A振動傳感器API返回數(shù)據(jù)集序號參數(shù)參數(shù)名稱類型長度備注1status振動強(qiáng)度Float4，2—A始播放API請求消息參數(shù)序號參數(shù)參數(shù)名稱類型長度備注1info提示語String—表A.32打開軟鍵盤API請求消息參數(shù)序號參數(shù)參數(shù)名稱類型長度備注1type鍵盤類型String詳見附錄B中的表B.62positionX橫坐標(biāo)位置t3—3positionY縱坐標(biāo)位置t3—DB35/T