1、 ICS 01.040.35 CCS L 72 35 福建省地方标准 DB35/T 20862022 政务服务 自助终端系统接口要求 Government servicesSelf-service terminal system interface requirements2022-10-27 发布2023-01-27 实施福建省市场监督管理局发 布 DB35/T 20862022I目次前言.II1范围.12规范性引用文件.13术语和定义.14缩略语.15总体要求.16接口分类.27接口功能要求.4附录 A（规范性）接口消息参数.7附录 B（资料性）数据字典.13参考文献.15DB35/T 2
2、0862022II前言本文件按照GB/T 1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由福建省经济信息中心提出。本文件由福建省信息化标准化技术委员会（SAFJ/TC 11）归口。本文件起草单位：福建省经济信息中心、厦门市行政审批管理局、厦门熙重电子科技有限公司、深圳太极数智技术有限公司、福建博思软件股份有限公司、福建省药品审核查验中心、福建船政交通职业学院。本文件主要起草人：俞希标、张瑞、林铃、王秀云、黄柳铃、黄条文、张建国、王翔龙、巩福。DB35/T 208620221政务服务自助
3、终端系统接口要求1范围本文件规定了政务服务自助终端接入各级政府部门政务服务应用的系统接口的总体要求、接口分类和接口功能要求。本文件适用于政务服务自助终端接入各级政府部门政务服务应用的系统接口开发、管理工作。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 39735政务服务评价工作指南3术语和定义GB/T 39735界定的以及下列术语和定义适用于本文件。3.1自助终端self-service terminal面向自然人、法人和其他组织提
4、供多部门政务服务应用的自助办理设备。3.2自助终端系统self-service terminal system安装在自助终端上，用于接入政务服务应用的系统。4缩略语下列缩略语适用于本文件。API：应用程序编程接口（Application Programming Interface）HTTPS：超文本传输安全协议（Hyper Text Transfer Protocol over Secure Socket Layer）JSON：JavaScript对象简普（JavaScript Object Notation）MAC：媒体存取控制（Media Access Control）REST：表述性状态
5、传递（Representational State Transfer）URL：统一资源定位符（Uniform Resource Locator）5总体要求5.1数据交换方式DB35/T 208620222数据交换接口应以REST架构的API接口形式发布，数据交换应采用HTTPS协议进行同步通讯，请求方式为POST。5.2数据交换消息要求数据交换接口消息应采用JSON字符串，以键值对（key-value）的形式封装。消息请求及响应参数的英文名为JSON键值对的键名（key）。消息编码格式采用UTF-8。5.3请求 URL 要求每个数据交换接口应对应一个唯一的URL：https:/127.0.0.
6、1:8801/二级类目代码/三级类目代码，通过该URL对接口进行访问。若无特别说明，二级类目代码和三级类目代码，应符合表2的要求。示例：读取居民身份证信息 API 调用地址：https:/127.0.0.1:8801/idcardManage/read5.4请求消息参数要求应符合如下要求：a)需要提交请求参数：请求数据交换接口的参数，具体的值应符合附录 A 的要求，所有参数组合应为 JSON，加载到请求体（body）,作为请求提交；b)不需要提交请求参数：直接通过请求 URL 进行访问。5.5响应消息参数要求响应消息格式应为JSON,响应消息参数应包含状态码、状态信息描述和返回数据集。响应消息
7、参数说明见表1。表 1响应消息参数说明序号参数参数名称类型类型名称参数说明1code状态码Int整型详见附录B中的表B.12msg状态信息描述String字符串返回情况描述信息3data返回数据集Object对象返回的数据结果集，采用JSON字符串表示；若需要返回数据集，应符合附录A的要求5.6接口性能要求应符合如下要求：a)自助终端系统接口服务加载的时间应小于 5 s；b)接口调用响应时间应小于 500 ms；c)接口连接超时时间设置不应大于 2 s。6接口分类自助终端系统接口按服务性质划分为证件读取服务、信息获取服务、打印服务、支付服务、图像服务、声音采集服务、信息提示服务和其它服务。服务
8、通过相应API接口对外提供。接口服务类目见表2。DB35/T 208620223表 2接口服务类目表序号一级类目二级类目二级类目代码三级类目三级类目代码1证件读取服务居民身份证读卡器idcardManage读取居民身份证信息APIread2出入境证件识读器crjcardManage读取出入境证件信息APIread3信息获取服务指纹仪fingerManage指纹采集APIfingerprInt4指纹比对APIvalidateFingerPrInt5条形码扫描器erCodeManage读条形码APIread6签字屏signManage开始签名APIstartSignature7结束签名APIsto
9、pSignature8设备信息deviceManage获取设备信息APIgain9获取设备硬件能力APIgainAbility10打印服务普通打印机printManage获取普通打印机状态APIgetStatus11打印文件APIprintFile12凭条打印机receiptPrintManage凭条打印内容APIwrite13切纸APIprintCutpaper14支付服务银行读卡器bankCardManange读取银行卡APIread15退出银行卡APIwithdrawCard16密码键盘eppManage读取按键值APIscanKeyPress17图像服务双目摄像头blCameraMan
10、age双目摄像头拍照APIlivingBodyDetect18人像比对APIfaceComp19高拍仪photographManage高拍仪拍照APIphotoGraph20图像处理imgprocessManage图像裁剪APIsmartCutOut21声音采集服务拾音器pickupManage开始录音APIopenMic22结束录音APIcloseMic23信息提示服务指示灯控设备ledManage指示灯状态设置APIsetLedStatus24传感器sensorManage人体感应传感器APIbodySensor25温湿度传感器APItempAndHumiditySensor26振动传感器
11、APIvibrationSensor27语音提示ttsManage开始播放APIspeak28停止播放APIstop29其它服务软键盘keyboardManage打开软键盘APIopen30关闭软键盘APIclose表2的二级类目中居民身份证读卡器、出入境证件识读器、指纹仪、条形码扫描器、签字屏、凭条打印机、银行卡读卡器、密码键盘、双目摄像头、高拍仪、拾音器、指示灯控设备还应包含如下三级类目：a)打开设备 API,三级类目代码为 open；b)关闭设备 API,三级类目代码为 close。打开设备API和关闭设备API用于打开/关闭相应的设备。DB35/T 2086202247接口功能要求证件
12、读取服务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
13、.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用于获取设备
14、硬件能力，可以返回设备支持的硬件能力信息，返回数据集应符合附录A中表A.12的要求。DB35/T 208620225打印服务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用于发送切纸方式来触
15、发凭条打印机进行切纸，请求消息参数应符合附录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
16、用于人像照片比对，并返回活体分数、比对结果等信息，请求消息参数应符合附录A中表A.22的要求,返回数据集应符合附录A中表A.23的要求。7.5.4图像裁剪 API用于对采集的图像进行裁剪，请求消息参数应符合附录A中表A.24的要求,返回数据集应符合附录A中表A.25的要求。DB35/T 208620226声音采集服务7.6.1开始录音 API用于触发拾音器开始录音，并把录音文件保存在指定路径，请求消息参数应符合附录A中表A.26的要求。7.6.2结束录音 API用于触发拾音器结束录音。信息提示服务7.7.1指示灯状态设置 API用于设置指示灯控设备的状态，请求消息参数应符合附录A中表A.27的
17、要求。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
18、.32的要求。7.8.2关闭软键盘 API用于关闭软键盘。DB35/T 208620227附录A（规范性）接口消息参数各接口请求消息参数和返回数据集见表A.1表A.32。表 A.1 读取居民身份证信息 API 请求消息参数序号参数参数名称类型长度备注1finger是否获取指纹Int10：否，1：是表 A.2 读取居民身份证信息 API 返回数据集序号参数参数名称类型长度备注1name姓名String502nation民族String403sex性别String24docNo证件号码String185birth出生日期String8日期格式：YYYYMMDD6address户籍地址String1
19、007startDate有效起始时间String8日期格式：YYYYMMDD8endDate有效截止时间String8日期格式：YYYYMMDD9regOffice签发机关String10010photo头像图片Stringbase64字符串11fingerImg指纹图片Stringbase64字符串表 A.3 读取出入境证件信息 API 返回数据集序号参数参数名称类型长度备注1docType证件类型String8详见附录B中的表B.22docNo证件号码String183chiName中文姓名String704engName英文姓名String705birth出生日期String8日期格式：
20、YYYYMMDD6sex性别String27expire有效期String8日期格式：YYYYMMDD8photo照片base64字符串Stringbase64字符串DB35/T 208620228表 A.4 指纹采集 API 返回数据集序号参数参数名称类型长度备注1imgData指纹图片字符串Stringbase64字符串2features指纹特征字符串String表 A.5 指纹比对 API 请求消息参数序号参数参数名称类型长度备注1fingerData1待比对的指纹数据1String特征值字符串或指纹图片base64字符串，具体依据type值来定2fingerData2待比对的指纹数据2
21、String3type比对类型Int10：特征值比对，1：图片比对表 A.6 指纹比对 API 返回数据集序号参数参数名称类型长度备注1score比对分数Int32result比对结果Int10：同一人，1：非同一人表 A.7 读条形码 API 返回数据集序号参数参数名称类型长度备注1result扫描内容String表 A.8 开始签名 API 返回数据集序号参数参数名称类型长度备注1result签字屏状态Int11：正在签名，2：签名结束，3：用户取消签名2image签名图片Stringbase64字符串表 A.9 结束签名 API 返回数据集序号参数参数名称类型长度备注1result操作结
22、果Int10：成功，其它：失败表 A.10 获取设备信息 API 请求消息参数序号参数参数名称类型长度备注1moduleCode事项编码String40DB35/T 208620229表 A.11 获取设备信息 API 返回数据集序号参数参数名称类型长度备注1deviceId设备idString322macAddress设备mac地址String17表 A.12 获取设备硬件能力 API 返回数据集序号参数参数名称类型长度备注1readIdCard读取居民身份证信息Int10：不支持，1：支持2readCrjCard读取出入境证件信息3fingerprInt指纹采集4validateFinge
23、rPrInt指纹比对5readErCode读取条形码Int10：不支持，1：支持6sign签字7printFile打印文件8receiptPrint打印凭条9printCutpaper凭条切纸10readBankCard读取银行卡11eppManage密码键盘12livingBodyDetect双目摄像头拍照13faceComp人像比对14smartCutOut图像裁剪15photoGraph高拍仪拍照16pickupManage录音17ledManage指示灯18bodySensor人体感应传感器19tempAndHumiditySensor温湿度传感器20vibrationSensor振动
24、传感器21ttsManage语音提示22keyboard软键盘表 A.13 获取普通打印机状态 API 返回数据集序号参数参数名称类型长度备注1status打印机状态码Int2详见附录B中的表B.3DB35/T 2086202210表 A.14 打印文件 API 请求消息参数序号参数参数名称类型长度备注1path打印文件绝对路径String是文件名（全路径），如C:/file.pdf，或者为文件下载URL（以http开头）表 A.15 打印文件 API 返回数据集序号参数参数名称类型长度备注1result执行结果Int10：正常，1：失败表 A.16 凭条打印内容 API 请求消息参数序号参数
25、参数名称类型长度备注1content打印内容String500非空项2type打印类型Int1非空项；0：字符串，1：一维条形码，2：二维码3lineSpace行间距Int3取值0-127，单位0.125mm4space字符间距Int3取值0-127，单位0.125mm5size字体大小Int1取值1-86qrSize二维码打印大小Int1取值1-4，默认47alignment水平对齐方式Int10：左对齐，1：居中，2：右对齐8bold是否加粗Int10：否，1：是9underline下划线Int10：无，1：一个点，2：两个点10line走纸行数Int211leftmargin左边距Int
26、3取值0-576，单位0.125mm表 A.17 切纸 API 请求消息参数序号参数参数名称类型长度备注1prIntCutpaper切纸方式Int1默认为0，0：全切，1：半切表 A.18 读取银行卡 API 返回数据集序号参数参数名称类型长度备注1cardNum银行卡卡号String19表 A.19 读取按键值 API 返回数据集序号参数参数名称类型长度备注1keyValue按键识别码String6详见附录B中的表B.4DB35/T 2086202211表 A.20 双目摄像头拍照 API 返回数据集序号参数参数名称类型长度备注1score活体分数Int22result是否为活体Int10：
27、否，1：是3livePhoto活体图像Stringbase64字符串4width宽度Int35height高度Int36dpi分辨率Int4表 A.21 高拍仪拍照 API 返回数据集序号参数参数名称类型长度备注1imgData图片Stringbase64字符串2dpi分辨率Int33width宽度Int34height高度Int3表 A.22 人像比对 API 请求消息参数序号参数参数名称类型长度备注1img1待比对人像图片1Stringbase64字符串2img2待比对人像图片2Stringbase64字符串表 A.23 人像比对 API 返回数据集序号参数参数名称类型长度备注1score
28、活体分数Int32similarity相似度Float5，23result是否为同一人Int10：否，1：是表 A.24 图像裁剪 API 请求消息参数序号参数参数名称类型长度备注1imgType图像类型Int10：A4纸，1：卡证类，2：其他2imgData输入图像Stringbase64字符串表 A.25 图像裁剪 API 返回数据集序号参数参数名称类型长度备注1imgData输出图像Stringbase64字符串DB35/T 2086202212表 A.26 开始录音 API 请求消息参数序号参数参数名称类型长度备注1filename录音文件存放路径String200表 A.27 指示灯
29、状态设置 API 请求消息参数序号参数参数名称类型长度备注1moduleId灯控板灯序Int2详见附录B中的表B.52status状态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 开始播放
30、API 请求消息参数序号参数参数名称类型长度备注1info提示语String100表 A.32 打开软键盘 API 请求消息参数序号参数参数名称类型长度备注1type键盘类型String10详见附录B中的表B.62positionX横坐标位置Int33positionY纵坐标位置Int3DB35/T 2086202213附录B（资料性）数据字典数据字典见表B.1表B.6。表 B.1 返回状态码编码值编码名称0成功1异常100非法授权4001初始化失败4002串口打开失败5001硬件错误6001设备正在执行操作7001请求参数解析出错8001data数据为空表 B.2 出入境证件类型编码值编码名
31、称EP电子护照HXZ电子港澳居民来往内地通行证（回乡证）TBZ电子台湾居民来往大陆通行证（台胞证）GAZ电子内地居民往来港澳通行证DLZ电子大陆居民往来台湾通行证JZZ港澳台居民居住证YJJLZ外国人永久居留证件表 B.3 普通打印机状态码编码值编码名称0打印正常1卡纸2缺纸或纸盒打开3打印机门打开4上盖打开5没有硒鼓6离线7其他错误8纸将尽DB35/T 2086202214表 B.4 密码键盘按键识别码编码值编码名称0数字01数字12数字23数字34数字45数字56数字67数字78数字89数字9cancel取消键delete删除键ok确认键表 B.5 灯控板灯序编码值编码名称1凭条打印机2居
32、民身份证读卡器3银行读卡器4密码键盘6高拍仪扫描口7打印机出纸口8打印机9条形码扫描器10高拍仪灯11出入境证件识读器12指纹仪表 B.6 软键盘类型编码值编码名称normal标准键盘number数字键盘telephone手机号码键盘idcard身份证键盘DB35/T 2086202215参考文献1国务院办公厅关于印发“互联网+政务服务”技术体系建设指南的通知（国办函2016108号）2国务院办公厅关于印发进一步深化“互联网+政务服务”推进政务服务“一网、一门、一次”改革实施方案的通知（国办发201845号）3国务院办公厅关于加快推进政务服务“跨省通办”的指导意见（国办发202035号）4全国一体化政务服务平台“跨省通办”服务专区建设规范（国办电政函2020104号）5关于推进政务自助终端“省内通办”工作的通知（闽数字办函2021107号）
