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

ICS01.040.35

CCSL72

35

福建省地方標準

DB35/T2086—2022

政務服務自助終端系統(tǒng)接口要求

Governmentservices—Self-serviceterminalsysteminterfacerequirements

DB35/T2086—2022

前言

本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定

起草。

請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構不承擔識別專利的責任。

本文件由福建省經(jīng)濟信息中心提出。

本文件由福建省信息化標準化技術委員會（SAFJ/TC11）歸口。

本文件起草單位：福建省經(jīng)濟信息中心、廈門市行政審批管理局、廈門熙重電子科技有限公司、

深圳太極數(shù)智技術有限公司、福建博思軟件股份有限公司、福建省藥品審核查驗中心、福建船政交通

職業(yè)學院。

本文件主要起草人：俞希標、張瑞、林鈴、王秀云、黃柳鈴、黃條文、張建國、王翔龍、鞏福。

II

DB35/T2086—2022

政務服務自助終端系統(tǒng)接口要求

1范圍

本文件規(guī)定了政務服務自助終端接入各級政府部門政務服務應用的系統(tǒng)接口的總體要求、接口分類

和接口功能要求。

本文件適用于政務服務自助終端接入各級政府部門政務服務應用的系統(tǒng)接口開發(fā)、管理工作。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T39735政務服務評價工作指南

3術語和定義

GB/T39735界定的以及下列術語和定義適用于本文件。

3.1

自助終端self-serviceterminal

面向自然人、法人和其他組織提供多部門政務服務應用的自助辦理設備。

3.2

自助終端系統(tǒng)self-serviceterminalsystem

安裝在自助終端上，用于接入政務服務應用的系統(tǒng)。

4縮略語

下列縮略語適用于本文件。

API：應用程序編程接口（ApplicationProgrammingInterface）

HTTPS：超文本傳輸安全協(xié)議（HyperTextTransferProtocoloverSecureSocketLayer）

JSON：JavaScript對象簡普（JavaScriptObjectNotation）

MAC：媒體存取控制（MediaAccessControl）

REST：表述性狀態(tài)傳遞（RepresentationalStateTransfer）

URL：統(tǒng)一資源定位符（UniformResourceLocator）

5總體要求

5.1數(shù)據(jù)交換方式

1

DB35/T2086—2022

數(shù)據(jù)交換接口應以REST架構的API接口形式發(fā)布，數(shù)據(jù)交換應采用HTTPS協(xié)議進行同步通訊，請求方

式為POST。

5.2數(shù)據(jù)交換消息要求

數(shù)據(jù)交換接口消息應采用JSON字符串，以鍵值對（key-value）的形式封裝。消息請求及響應參數(shù)

的英文名為JSON鍵值對的鍵名（key）。消息編碼格式采用UTF-8。

5.3請求URL要求

每個數(shù)據(jù)交換接口應對應一個唯一的URL：:8801/二級類目代碼/三級類目代碼，

通過該URL對接口進行訪問。若無特別說明，二級類目代碼和三級類目代碼，應符合表2的要求。

示例：讀取居民身份證信息API調(diào)用地址：:8801/idcardManage/read

5.4請求消息參數(shù)要求

應符合如下要求：

a)需要提交請求參數(shù)：請求數(shù)據(jù)交換接口的參數(shù)，具體的值應符合附錄A的要求，所有參數(shù)組

合應為JSON，加載到請求體（body）,作為請求提交；

b)不需要提交請求參數(shù)：直接通過請求URL進行訪問。

5.5響應消息參數(shù)要求

響應消息格式應為JSON,響應消息參數(shù)應包含狀態(tài)碼、狀態(tài)信息描述和返回數(shù)據(jù)集。響應消息參數(shù)

說明見表1。

表1響應消息參數(shù)說明

序號參數(shù)參數(shù)名稱類型類型名稱參數(shù)說明

1code狀態(tài)碼Int整型詳見附錄B中的表B.1

2msg狀態(tài)信息描述String字符串返回情況描述信息

返回的數(shù)據(jù)結果集，采用JSON字符串表示；若需要返回數(shù)據(jù)集，

3data返回數(shù)據(jù)集Object對象

應符合附錄A的要求

5.6接口性能要求

應符合如下要求：

a)自助終端系統(tǒng)接口服務加載的時間應小于5s；

b)接口調(diào)用響應時間應小于500ms；

c)接口連接超時時間設置不應大于2s。

6接口分類

自助終端系統(tǒng)接口按服務性質(zhì)劃分為證件讀取服務、信息獲取服務、打印服務、支付服務、圖像服

務、聲音采集服務、信息提示服務和其它服務。服務通過相應API接口對外提供。

接口服務類目見表2。

2

DB35/T2086—2022

表2接口服務類目表

序號一級類目二級類目二級類目代碼三級類目三級類目代碼

1居民身份證讀卡器idcardManage讀取居民身份證信息APIread

證件讀取服務

2出入境證件識讀器crjcardManage讀取出入境證件信息APIread

3指紋采集APIfingerprInt

指紋儀fingerManage

4指紋比對APIvalidateFingerPrInt

5條形碼掃描器erCodeManage讀條形碼APIread

6信息獲取服務開始簽名APIstartSignature

簽字屏signManage

7結束簽名APIstopSignature

8獲取設備信息APIgain

設備信息deviceManage

9獲取設備硬件能力APIgainAbility

10獲取普通打印機狀態(tài)APIgetStatus

普通打印機printManage

11打印文件APIprintFile

打印服務

12憑條打印內(nèi)容APIwrite

憑條打印機receiptPrintManage

13切紙APIprintCutpaper

14讀取銀行卡APIread

銀行讀卡器bankCardManange

15支付服務退出銀行卡APIwithdrawCard

16密碼鍵盤eppManage讀取按鍵值APIscanKeyPress

17雙目攝像頭拍照APIlivingBodyDetect

雙目攝像頭blCameraManage

18人像比對APIfaceComp

圖像服務

19高拍儀photographManage高拍儀拍照APIphotoGraph

20圖像處理imgprocessManage圖像裁剪APIsmartCutOut

21開始錄音APIopenMic

聲音采集服務拾音器pickupManage

22結束錄音APIcloseMic

23指示燈控設備ledManage指示燈狀態(tài)設置APIsetLedStatus

24人體感應傳感器APIbodySensor

25傳感器sensorManage溫濕度傳感器APItempAndHumiditySensor

信息提示服務

26振動傳感器APIvibrationSensor

27開始播放APIspeak

語音提示ttsManage

28停止播放APIstop

29打開軟鍵盤APIopen

其它服務軟鍵盤keyboardManage

30關閉軟鍵盤APIclose

表2的二級類目中居民身份證讀卡器、出入境證件識讀器、指紋儀、條形碼掃描器、簽字屏、憑條打印機、

銀行卡讀卡器、密碼鍵盤、雙目攝像頭、高拍儀、拾音器、指示燈控設備還應包含如下三級類目：

a)打開設備API,三級類目代碼為open；

b)關閉設備API,三級類目代碼為close。

打開設備API和關閉設備API用于打開/關閉相應的設備。

3

DB35/T2086—2022

7接口功能要求

證件讀取服務

7.1.1讀取居民身份證信息API

用于讀取居民身份證信息，并返回姓名、證件號碼、出生日期等信息，請求消息參數(shù)應符合附錄A

中表A.1的要求,返回數(shù)據(jù)集應符合附錄A中表A.2的要求。

7.1.2讀取出入境證件信息API

用于讀取出入境證件信息，并返回中文姓名、英文姓名、證件號碼等信息，返回數(shù)據(jù)集應符合附錄

A中表A.3的要求。

信息獲取服務

7.2.1指紋采集API

用于執(zhí)行指紋采集的操作，并返回指紋圖片、指紋特征值等信息，返回數(shù)據(jù)集應符合附錄A中表A.4

的要求。

7.2.2指紋比對API

用于通過傳入兩組指紋特征值或指紋圖片進行比對，并返回比對分數(shù)、比對結果等信息，請求消息

參數(shù)應符合附錄A中表A.5的要求,返回數(shù)據(jù)集應符合附錄A中表A.6的要求。

7.2.3讀條形碼API

用于讀取一維條碼和二維條碼，并返回相應的條形碼值，返回數(shù)據(jù)集應符合附錄A中表A.7的要求。

7.2.4開始簽名API

用于開始記錄簽名信息，并返回簽字屏狀態(tài)、簽名圖片等信息，返回數(shù)據(jù)集應符合附錄A中表A.8

的要求。

7.2.5結束簽名API

用于結束簽名，返回數(shù)據(jù)集應符合附錄A中表A.9的要求。

7.2.6獲取設備信息API

用于通過事項編碼來獲取設備信息，可以返回設備ID、MAC地址等信息，請求消息參數(shù)應符合附錄A

中表A.10的要求，返回數(shù)據(jù)集應符合附錄A中表A.11的要求。

7.2.7獲取設備硬件能力API

用于獲取設備硬件能力，可以返回設備支持的硬件能力信息，返回數(shù)據(jù)集應符合附錄A中表A.12的

要求。

4

DB35/T2086—2022

打印服務

7.3.1獲取普通打印機狀態(tài)API

用于獲取普通打印機的狀態(tài)信息，返回數(shù)據(jù)集應符合附錄A中表A.13的要求。

7.3.2打印文件API

用于發(fā)送文件給普通打印機進行打印，并返回打印執(zhí)行結果信息，請求消息參數(shù)應符合附錄A中表

A.14的要求,返回數(shù)據(jù)集應符合附錄A中表A.15的要求。

7.3.3憑條打印內(nèi)容API

用于發(fā)送打印內(nèi)容、打印類型、行間距等信息給憑條打印機，憑條打印機根據(jù)信息進行打印，請求

消息參數(shù)應符合附錄A中表A.16的要求。

7.3.4切紙API

用于發(fā)送切紙方式來觸發(fā)憑條打印機進行切紙，請求消息參數(shù)應符合附錄A中表A.17的要求。

支付服務

7.4.1讀取銀行卡API

用于讀取銀行卡信息，并返回銀行卡號等信息，返回數(shù)據(jù)集應符合附錄A中表A.18的要求。

7.4.2退出銀行卡API

用于讓銀行讀卡器退出銀行卡。

7.4.3讀取按鍵值API

用于讀取密碼鍵盤的按鍵值，返回數(shù)據(jù)集應符合附錄A中表A.19的要求。

圖像服務

7.5.1雙目攝像頭拍照API

用于使用雙目攝像頭進行拍照，并返回照片信息，返回數(shù)據(jù)集應符合附錄A中表A.20的要求。

7.5.2高拍儀拍照API

用于使用高拍儀進行拍照，并返回照片信息,返回數(shù)據(jù)集應符合附錄A中表A.21的要求。

7.5.3人像比對API

用于人像照片比對，并返回活體分數(shù)、比對結果等信息，請求消息參數(shù)應符合附錄A中表A.22的要

求,返回數(shù)據(jù)集應符合附錄A中表A.23的要求。

7.5.4圖像裁剪API

用于對采集的圖像進行裁剪，請求消息參數(shù)應符合附錄A中表A.24的要求,返回數(shù)據(jù)集應符合附錄A

中表A.25的要求。

5

DB35/T2086—2022

聲音采集服務

7.6.1開始錄音API

用于觸發(fā)拾音器開始錄音，并把錄音文件保存在指定路徑，請求消息參數(shù)應符合附錄A中表A.26的

要求。

7.6.2結束錄音API

用于觸發(fā)拾音器結束錄音。

信息提示服務

7.7.1指示燈狀態(tài)設置API

用于設置指示燈控設備的狀態(tài)，請求消息參數(shù)應符合附錄A中表A.27的要求。

7.7.2人體感應傳感器API

用于獲取人體感應傳感器狀態(tài)，返回是否有人等信息，返回數(shù)據(jù)集應符合附錄A中表A.28的要求。

7.7.3溫濕度傳感器API

用于獲取溫濕度傳感器的狀態(tài)，返回溫度、濕度等信息，返回數(shù)據(jù)集應符合附錄A中表A.29的要求。

7.7.4振動傳感器API

用于獲取振動傳感器的狀態(tài)，返回振動強度等信息，返回數(shù)據(jù)集應符合附錄A中表A.30的要求。

7.7.5開始播放API

用于通過揚聲器播放指定的提示語，請求消息參數(shù)應符合附錄A中表A.31的要求。

7.7.6停止播放API

用于觸發(fā)揚聲器停止播放。

其它服務

7.8.1打開軟鍵盤API

用于打開軟鍵盤，請求消息參數(shù)應符合附錄A中表A.32的要求。

7.8.2關閉軟鍵盤API

用于關閉軟鍵盤。

6

DB35/T2086—2022

附錄A

（規(guī)范性）

接口消息參數(shù)

各接口請求消息參數(shù)和返回數(shù)據(jù)集見表A.1～表A.32。

表A.1讀取居民身份證信息API請求消息參數(shù)

序號參數(shù)參數(shù)名稱類型長度備注

1finger是否獲取指紋Int10：否，1：是

表A.2讀取居民身份證信息API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1name姓名String50—

2nation民族String40—

3sex性別String2—

4docNo證件號碼String18—

5birth出生日期String8日期格式：YYYYMMDD

6address戶籍地址String100—

7startDate有效起始時間String8日期格式：YYYYMMDD

8endDate有效截止時間String8日期格式：YYYYMMDD

9regOffice簽發(fā)機關String100—

10photo頭像圖片String—base64字符串

11fingerImg指紋圖片String—base64字符串

表A.3讀取出入境證件信息API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1docType證件類型String8詳見附錄B中的表B.2

2docNo證件號碼String18—

3chiName中文姓名String70—

4engName英文姓名String70—

5birth出生日期String8日期格式：YYYYMMDD

6sex性別String2—

7expire有效期String8日期格式：YYYYMMDD

8photo照片base64字符串String—base64字符串

7

DB35/T2086—2022

表A.4指紋采集API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1imgData指紋圖片字符串String—base64字符串

2features指紋特征字符串String——

表A.5指紋比對API請求消息參數(shù)

序號參數(shù)參數(shù)名稱類型長度備注

1fingerData1待比對的指紋數(shù)據(jù)1String—特征值字符串或指紋圖片base64字符串，具體

2fingerData2待比對的指紋數(shù)據(jù)2String—依據(jù)type值來定

3type比對類型Int10：特征值比對，1：圖片比對

表A.6指紋比對API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1score比對分數(shù)Int3—

2result比對結果Int10：同一人，1：非同一人

表A.7讀條形碼API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1result掃描內(nèi)容String——

表A.8開始簽名API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1：正在簽名，2：簽名結束，3：用戶取消

1result簽字屏狀態(tài)Int1

簽名

2image簽名圖片String—base64字符串

表A.9結束簽名API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1result操作結果Int10：成功，其它：失敗

表A.10獲取設備信息API請求消息參數(shù)

序號參數(shù)參數(shù)名稱類型長度備注

1moduleCode事項編碼String40—

8

DB35/T2086—2022

表A.11獲取設備信息API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1deviceId設備idString32—

2macAddress設備mac地址String17—

表A.12獲取設備硬件能力API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1readIdCard讀取居民身份證信息

2readCrjCard讀取出入境證件信息

Int10：不支持，1：支持

3fingerprInt指紋采集

4validateFingerPrInt指紋比對

5readErCode讀取條形碼

6sign簽字

7printFile打印文件

8receiptPrint打印憑條

9printCutpaper憑條切紙

10readBankCard讀取銀行卡

11eppManage密碼鍵盤

12livingBodyDetect雙目攝像頭拍照

13faceComp人像比對

Int10：不支持，1：支持

14smartCutOut圖像裁剪

15photoGraph高拍儀拍照

16pickupManage錄音

17ledManage指示燈

18bodySensor人體感應傳感器

19tempAndHumiditySensor溫濕度傳感器

20vibrationSensor振動傳感器

21ttsManage語音提示

22keyboard軟鍵盤

表A.13獲取普通打印機狀態(tài)API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1status打印機狀態(tài)碼Int2詳見附錄B中的表B.3

9

DB35/T2086—2022

表A.14打印文件API請求消息參數(shù)

序號參數(shù)參數(shù)名稱類型長度備注

文件名（全路徑），如C:/file.pdf，或者為文

1path打印文件絕對路徑String是

件下載URL（以http開頭）

表A.15打印文件API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1result執(zhí)行結果Int10：正常，1：失敗

表A.16憑條打印內(nèi)容API請求消息參數(shù)

序號參數(shù)參數(shù)名稱類型長度備注

1content打印內(nèi)容String500非空項

非空項；

2type打印類型Int1

0：字符串，1：一維條形碼，2：二維碼

3lineSpace行間距Int3取值0-127，單位0.125mm

4space字符間距Int3取值0-127，單位0.125mm

5size字體大小Int1取值1-8

6qrSize二維碼打印大小Int1取值1-4，默認4

7alignment水平對齊方式Int10：左對齊，1：居中，2：右對齊

8bold是否加粗Int10：否，1：是

9underline下劃線Int10：無，1：一個點，2：兩個點

10line走紙行數(shù)Int2—

11leftmargin左邊距Int3取值0-576，單位0.125mm

表A.17切紙API請求消息參數(shù)

序號參數(shù)參數(shù)名稱類型長度備注

1prIntCutpaper切紙方式Int1默認為0，0：全切，1：半切

表A.18讀取銀行卡API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1cardNum銀行卡卡號String19—

表A.19讀取按鍵值API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1keyValue按鍵識別碼String6詳見附錄B中的表B.4

10

DB35/T2086—2022

表A.20雙目攝像頭拍照API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1score活體分數(shù)Int2—

2result是否為活體Int10：否，1：是

3livePhoto活體圖像String—base64字符串

4width寬度Int3—

5height高度Int3—

6dpi分辨率Int4—

表A.21高拍儀拍照API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1imgData圖片String—base64字符串

2dpi分辨率Int3—

3width寬度Int3—

4height高度Int3—

表A.22人像比對API請求消息參數(shù)

序號參數(shù)參數(shù)名稱類型長度備注

1img1待比對人像圖片1String—base64字符串

2img2待比對人像圖片2String—base64字符串

表A.23人像比對API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1score活體分數(shù)Int3—

2similarity相似度Float5，2—

3result是否為同一人Int10：否，1：是

表A.24圖像裁剪API請求消息參數(shù)

序號參數(shù)參數(shù)名稱類型長度備注

1imgType圖像類型Int10：A4紙，1：卡證類，2：其他

2imgData輸入圖像String—base64字符串

表A.25圖像裁剪API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1imgData輸出圖像String—base64字符串

11

DB35/T2086—2022

表A.26開始錄音API請求消息參數(shù)

序號參數(shù)參數(shù)名稱類型長度備注

1filename錄音文件存放路徑String200—

表A.27指示燈狀態(tài)設置API請求消息參數(shù)

序號參數(shù)參數(shù)名稱類型長度備注

1moduleId燈控板燈序Int2詳見附錄B中的表B.5

2status狀態(tài)Int10：關閉，1：常亮，2：閃爍

表A.28人體感應傳感器API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1status是否有人Int10：有人，1：無人

表A.29溫濕度傳感器API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1temperature溫度Float4，2單位攝氏度

2humidity濕度Float4，2百分比

表A.30振動傳感器API返回數(shù)據(jù)集

序號參數(shù)參數(shù)名稱類型長度備注

1status振動強度Float4，2—

表A.31開始播放API請求消息參數(shù)

序號參數(shù)參數(shù)名稱類型長度備注

1info提示語String100—

表A.32打開軟鍵盤API請求消息參數(shù)

序號參數(shù)參數(shù)名稱類型長度備注

1type鍵盤類型String10詳見附錄B中的表B.6

2positionX橫坐標位置Int3—

3positionY縱坐標位置Int3—

12

DB35/T2086—2022

附錄B

（資料性）

數(shù)據(jù)字典

數(shù)據(jù)字典見表B.1～表B.6。

表B.1返回狀態(tài)碼

編碼值編碼名稱

0成功

1異常

100非法授權

4001初始化失敗

4002串口打開失敗

5001硬件錯誤

6001設備正在執(zhí)行操作

7001請求參數(shù)解析出錯

8001data數(shù)據(jù)為空

表B.2出入境證件類型

編碼值編碼名稱

EP電子護照

HXZ電子港澳居民來往內(nèi)地通行證（回鄉(xiāng)證）

TBZ電子臺灣居民來往大陸通行證（臺胞證）

GAZ電子內(nèi)地居民往來港