DB35T 2086-2022 政务服务 自助终端系统接口要求

ICS01.040.35

CCSL72

35

福建省地方标准

DB35/T2086—2022

政务服务自助终端系统接口要求

Governmentservices—Self-serviceterminalsysteminterfacerequirements

DB35/T2086—2022

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由福建省经济信息中心提出。

本文件由福建省信息化标准化技术委员会（SAFJ/TC11）归口。

本文件起草单位：福建省经济信息中心、厦门市行政审批管理局、厦门熙重电子科技有限公司、

深圳太极数智技术有限公司、福建博思软件股份有限公司、福建省药品审核查验中心、福建船政交通

职业学院。

本文件主要起草人：俞希标、张瑞、林铃、王秀云、黄柳铃、黄条文、张建国、王翔龙、巩福。

II

DB35/T2086—2022

政务服务自助终端系统接口要求

1范围

本文件规定了政务服务自助终端接入各级政府部门政务服务应用的系统接口的总体要求、接口分类

和接口功能要求。

本文件适用于政务服务自助终端接入各级政府部门政务服务应用的系统接口开发、管理工作。

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数据交换方式

1

DB35/T2086—2022

数据交换接口应以REST架构的API接口形式发布，数据交换应采用HTTPS协议进行同步通讯，请求方

式为POST。

5.2数据交换消息要求

数据交换接口消息应采用JSON字符串，以键值对（key-value）的形式封装。消息请求及响应参数

的英文名为JSON键值对的键名（key）。消息编码格式采用UTF-8。

5.3请求URL要求

每个数据交换接口应对应一个唯一的URL：:8801/二级类目代码/三级类目代码，

通过该URL对接口进行访问。若无特别说明，二级类目代码和三级类目代码，应符合表2的要求。

示例：读取居民身份证信息API调用地址：:8801/idcardManage/read

5.4请求消息参数要求

应符合如下要求：

a)需要提交请求参数：请求数据交换接口的参数，具体的值应符合附录A的要求，所有参数组

合应为JSON，加载到请求体（body）,作为请求提交；

b)不需要提交请求参数：直接通过请求URL进行访问。

5.5响应消息参数要求

响应消息格式应为JSON,响应消息参数应包含状态码、状态信息描述和返回数据集。响应消息参数

说明见表1。

表1响应消息参数说明

序号参数参数名称类型类型名称参数说明

1code状态码Int整型详见附录B中的表B.1

2msg状态信息描述String字符串返回情况描述信息

返回的数据结果集，采用JSON字符串表示；若需要返回数据集，

3data返回数据集Object对象

应符合附录A的要求

5.6接口性能要求

应符合如下要求：

a)自助终端系统接口服务加载的时间应小于5s；

b)接口调用响应时间应小于500ms；

c)接口连接超时时间设置不应大于2s。

6接口分类

自助终端系统接口按服务性质划分为证件读取服务、信息获取服务、打印服务、支付服务、图像服

务、声音采集服务、信息提示服务和其它服务。服务通过相应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获取普通打印机状态APIgetStatus

普通打印机printManage

11打印文件APIprintFile

打印服务

12凭条打印内容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指示灯状态设置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

用于读取居民身份证信息，并返回姓名、证件号码、出生日期等信息，请求消息参数应符合附录A

中表A.1的要求,返回数据集应符合附录A中表A.2的要求。

7.1.2读取出入境证件信息API

用于读取出入境证件信息，并返回中文姓名、英文姓名、证件号码等信息，返回数据集应符合附录

A中表A.3的要求。

信息获取服务

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的

要求。

4

DB35/T2086—2022

打印服务

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.1读取银行卡API

用于读取银行卡信息，并返回银行卡号等信息，返回数据集应符合附录A中表A.18的要求。

7.4.2退出银行卡API

用于让银行读卡器退出银行卡。

7.4.3读取按键值API

用于读取密码键盘的按键值，返回数据集应符合附录A中表A.19的要求。

图像服务

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的要求。

5

DB35/T2086—2022

声音采集服务

7.6.1开始录音API

用于触发拾音器开始录音，并把录音文件保存在指定路径，请求消息参数应符合附录A中表A.26的

要求。

7.6.2结束录音API

用于触发拾音器结束录音。

信息提示服务

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.1打开软键盘API

用于打开软键盘，请求消息参数应符合附录A中表A.32的要求。

7.8.2关闭软键盘API

用于关闭软键盘。

6

DB35/T2086—2022

附录A

（规范性）

接口消息参数

各接口请求消息参数和返回数据集见表A.1～表A.32。

表A.1读取居民身份证信息API请求消息参数

序号参数参数名称类型长度备注

1finger是否获取指纹Int10：否，1：是

表A.2读取居民身份证信息API返回数据集

序号参数参数名称类型长度备注

1name姓名String50—

2nation民族String40—

3sex性别String2—

4docNo证件号码String18—

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

6address户籍地址String100—

7startDate有效起始时间String8日期格式：YYYYMMDD

8endDate有效截止时间String8日期格式：YYYYMMDD

9regOffice签发机关String100—

10photo头像图片String—base64字符串

11fingerImg指纹图片String—base64字符串

表A.3读取出入境证件信息API返回数据集

序号参数参数名称类型长度备注

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返回数据集

序号参数参数名称类型长度备注

1imgData指纹图片字符串String—base64字符串

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

表A.5指纹比对API请求消息参数

序号参数参数名称类型长度备注

1fingerData1待比对的指纹数据1String—特征值字符串或指纹图片base64字符串，具体

2fingerData2待比对的指纹数据2String—依据type值来定

3type比对类型Int10：特征值比对，1：图片比对

表A.6指纹比对API返回数据集

序号参数参数名称类型长度备注

1score比对分数Int3—

2result比对结果Int10：同一人，1：非同一人

表A.7读条形码API返回数据集

序号参数参数名称类型长度备注

1result扫描内容String——

表A.8开始签名API返回数据集

序号参数参数名称类型长度备注

1：正在签名，2：签名结束，3：用户取消

1result签字屏状态Int1

签名

2image签名图片String—base64字符串

表A.9结束签名API返回数据集

序号参数参数名称类型长度备注

1result操作结果Int10：成功，其它：失败

表A.10获取设备信息API请求消息参数

序号参数参数名称类型长度备注

1moduleCode事项编码String40—

8

DB35/T2086—2022

表A.11获取设备信息API返回数据集

序号参数参数名称类型长度备注

1deviceId设备idString32—

2macAddress设备mac地址String17—

表A.12获取设备硬件能力API返回数据集

序号参数参数名称类型长度备注

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获取普通打印机状态API返回数据集

序号参数参数名称类型长度备注

1status打印机状态码Int2详见附录B中的表B.3

9

DB35/T2086—2022

表A.14打印文件API请求消息参数

序号参数参数名称类型长度备注

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

1path打印文件绝对路径String是

件下载URL（以http开头）

表A.15打印文件API返回数据集

序号参数参数名称类型长度备注

1result执行结果Int10：正常，1：失败

表A.16凭条打印内容API请求消息参数

序号参数参数名称类型长度备注

1content打印内容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走纸行数Int2—

11leftmargin左边距Int3取值0-576，单位0.125mm

表A.17切纸API请求消息参数

序号参数参数名称类型长度备注

1prIntCutpaper切纸方式Int1默认为0，0：全切，1：半切

表A.18读取银行卡API返回数据集

序号参数参数名称类型长度备注

1cardNum银行卡卡号String19—

表A.19读取按键值API返回数据集

序号参数参数名称类型长度备注

1keyValue按键识别码String6详见附录B中的表B.4

10

DB35/T2086—2022

表A.20双目摄像头拍照API返回数据集

序号参数参数名称类型长度备注

1score活体分数Int2—

2result是否为活体Int10：否，1：是

3livePhoto活体图像String—base64字符串

4width宽度Int3—

5height高度Int3—

6dpi分辨率Int4—

表A.21高拍仪拍照API返回数据集

序号参数参数名称类型长度备注

1imgData图片String—base64字符串

2dpi分辨率Int3—

3width宽度Int3—

4height高度Int3—

表A.22人像比对API请求消息参数

序号参数参数名称类型长度备注

1img1待比对人像图片1String—base64字符串

2img2待比对人像图片2String—base64字符串

表A.23人像比对API返回数据集

序号参数参数名称类型长度备注

1score活体分数Int3—

2similarity相似度Float5，2—

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

表A.24图像裁剪API请求消息参数

序号参数参数名称类型长度备注

1imgType图像类型Int10：A4纸，1：卡证类，2：其他

2imgData输入图像String—base64字符串

表A.25图像裁剪API返回数据集

序号参数参数名称类型长度备注

1imgData输出图像String—base64字符串

11

DB35/T2086—2022

表A.26开始录音API请求消息参数

序号参数参数名称类型长度备注

1filename录音文件存放路径String200—

表A.27指示灯状态设置API请求消息参数

序号参数参数名称类型长度备注

1moduleId灯控板灯序Int2详见附录B中的表B.5

2status状态Int10：关闭，1：常亮，2：闪烁

表A.28人体感应传感器API返回数据集

序号参数参数名称类型长度备注

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

表A.29温湿度传感器API返回数据集

序号参数参数名称类型长度备注

1temperature温度Float4，2单位摄氏度

2humidity湿度Float4，2百分比

表A.30振动传感器API返回数据集

序号参数参数名称类型长度备注

1status振动强度Float4，2—

表A.31开始播放API请求消息参数

序号参数参数名称类型长度备注

1info提示语String100—

表A.32打开软键盘API请求消息参数

序号参数参数名称类型长度备注

1type键盘类型String10详见附录B中的表B.6

2positionX横坐标位置Int3—

3positionY纵坐标位置Int3—

12

DB35/T2086—2022

附录B

（资料性）

数据字典

数据字典见表B.1～表B.6。

表B.1返回状态码

编码值编码名称

0成功

1异常

100非法授权

4001初始化失败

4002串口打开失败

5001硬件错误

6001设备正在执行操作

7001请求参数解析出错

8001data数据为空

表B.2出入境证件类型

编码值编码名称

EP电子护照

HXZ电子港澳居民来往内地通行证（回乡证）

TBZ电子台湾居民来往大陆通行证（台胞证）

GAZ电子内地居民往来港