ICS 01.040.35 CCS L 72 35 福建省 地方标准 DB35/T 2086—2022 政务服务 自助终端系统接口要求 Government services —Self-service terminal system interface requirements 2022 - 10 - 27发布 2023 - 01 - 27实施 福建省市场监督管理局 发布 DB35/T2086—2022 I目次 前言..................................................................................II 1范围................................................................................1 2规范性引用文件......................................................................1 3术语和定义..........................................................................1 4缩略语..............................................................................1 5总体要求............................................................................1 6接口分类............................................................................2 7接口功能要求........................................................................4 附录A（规范性）接口消息参数..........................................................7 附录B（资料性）数据字典.............................................................13 参考文献..............................................................................15 DB35/T2086—2022 II前言 本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由福建省经济信息中心提出。 本文件由福建省信息化标准化技术委员会（SAFJ/TC11）归口。 本文件起草单位：福建省经济信息中心、厦门市行政审批管理局、厦门熙重电子科技有限公司、 深圳太极数智技术有限公司、福建博思软件股份有限公司、福建省药品审核查验中心、福建船政交通 职业学院。 本文件主要起草人：俞希标、张瑞、林铃、王秀云、黄柳铃、黄条文、张建国、王翔龙、巩福。 DB35/T2086—2022 1政务服务自助终端系统接口要求 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数据交换方式 DB35/T2086—2022 2数据交换接口应以REST架构的API接口形式发布，数据交换应采用HTTPS协议进行同步通讯，请求方 式为POST。 5.2数据交换消息要求 数据交换接口消息应采用JSON字符串，以键值对（key-value）的形式封装。消息请求及响应参数 的英文名为JSON键值对的键名（key）。消息编码格式采用UTF-8。 5.3请求URL要求 每个数据交换接口应对应一个唯一的URL：https://127.0.0.1:8801/二级类目代码/三级类目代码， 通过该URL对接口进行访问。若无特别说明，二级类目代码和三级类目代码，应符合表2的要求。 示例：读取居民身份证信息API调用地址：https://127.0.0.1:8801/idcardManage/read 5.4请求消息参数要求 应符合如下要求： a)需要提交请求参数：请求数据交换接口的参数，具体的值应符合附录A的要求，所有参数组 合应为JSON，加载到请求体（body）,作为请求提交； b)不需要提交请求参数：直接通过请求URL进行访问。 5.5响应消息参数要求 响应消息格式应为JSON,响应消息参数应包含状态码、状态信息描述和返回数据集。响应消息参数 说明见表1。 表1响应消息参数说明 序号参数参数名称类型类型名称 参数说明 1code状态码 Int 整型 详见附录B中的表B.1 2msg状态信息描述String字符串 返回情况描述信息 3data返回数据集Object对象返回的数据结果集，采用JSON字符串表示；若需要返回数据集， 应符合附录A的要求 5.6接口性能要求 应符合如下要求： a)自助终端系统接口服务加载的时间应小于5s； b)接口调用响应时间应小于500ms； c)接口连接超时时间设置不应大于2s。 6接口分类 自助终端系统接口按服务性质划分为证件读取服务、信息获取服务、打印服务、支付服务、图像服 务、声音采集服务、信息提示服务和其它服务。服务通过相应API接口对外提供。 接口服务类目见表2。 DB35/T2086—2022 3表2接口服务类目表 序号一级类目 二级类目 二级类目代码 三级类目 三级类目代码 1 证件读取服务居民身份证读卡器idcardManage读取居民身份证信息API read 2 出入境证件识读器crjcardManage读取出入境证件信息API read 3 信息获取服务指纹仪 fingerManage指纹采集API fingerprInt 4 指纹比对API validateFingerPrInt 5 条形码扫描器 erCodeManage 读条形码API read 6 签字屏 signManage开始签名API startSignature 7 结束签名API stopSignature 8 设备信息 deviceManage获取设备信息API gain 9 获取设备硬件能力API gainAbility 10 打印服务普通打印机 printManage获取普通打印机状态API getStatus 11 打印文件API printFile 12 凭条打印机receiptPrintManage凭条打印内容API write 13 切纸API printCutpaper 14 支付服务银行读卡器bankCardManange读取银行卡API read 15 退出银行卡API withdrawCard 16 密码键盘 eppManage 读取按键值API scanKeyPress 17 图像服务双目摄像头 blCameraManage双目摄像头拍照API livingBodyDetect 18 人像比对API faceComp 19 高拍仪 photographManage 高拍仪拍照API photoGraph 20 图像处理 imgprocessManage 图像裁剪API smartCutOut 21 声音采集服务 拾音器 pickupManage开始录音API openMic 22 结束录音API closeMic 23 信息提示服务指示灯控设备 ledManage 指示灯状态设置API setLedStatus 24 传感器 sensorManage人体感应传感器API bodySensor 25 温湿度传感器APItempAndHumiditySensor 26 振动传感器API