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

ICS01.040.35

CCSL72

35

福建省地方标准

DB35/T2086—2022

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

Governmentservices—Self-serviceterminalsysteminterfacerequirements

2022-10-27发布2023-01-27实施

福建省市场监督管理局发布

DB35/T2086—2022

目次

前言..................................................................................II

1范围................................................................................1

2规范性引用文件......................................................................1

3术语和定义..........................................................................1

4缩略语..............................................................................1

5总体要求............................................................................1

6接口分类............................................................................2

7接口功能要求........................................................................4

附录A（规范性）接口消息参数..........................................................7

附录B（资料性）数据字典.............................................................13

参考文献..............................................................................15

I

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

用于结束签名，