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

35Governmentservices—Self-serviceterminalsysteminterfacereIDB35/T2086—2022前言 2规范性引用文件 3术语和定义 4缩略语 5总体要求 6接口分类 27接口功能要求 4附录A（规范性）接口消息参数 7附录B（资料性）数据字典 13参考文献 DB35/T2086—2022本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由福建省经济信息中心提出。本文件由福建省信息化标准化技术委员会（SAFJ/TC11）归口。本文件起草单位：福建省经济信息中心、厦门市行政审批管理局、厦门熙重电子科技有限公司、深圳太极数智技术有限公司、福建博思软件股份有限公司、福建省药品审核查验中心、福建船政交通职业学院。本文件主要起草人：俞希标、张瑞、林铃、王秀云、黄柳铃、黄条文、张建国、王翔龙、巩福。1DB35/T2086—2022政务服务自助终端系统接口要求本文件规定了政务服务自助终端接入各级政府部门政务服务应用的系统接口的总体要求、接口分类和接口功能要求。本文件适用于政务服务自助终端接入各级政府部门政务服务应用的系统接口开发、管理工作。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数据交换方式2DB35/T2086—2022数据交换接口应以REST架构的API接口形式发布，数据交换应采用HTTPS协议进行同步通讯，请求方式为POST。5.2数据交换消息要求数据交换接口消息应采用JSON字符串，以键值对（key-value）的形式封装。消息请求及响应参数的英文名为JSON键值对的键名（key）。消息编码格式采用UTF-8。5.3请求URL要求每个数据交换接口应对应一个唯一的URL：:8801/二级类目代码/三级类目代码，通过该URL对接口进行访问。若无特别说明，二级类目代码和三级类目代码，应符合表2的要求。示例：读取居民身份证信息API调用地址：5.4请求消息参数要求应符合如下要求：a)需要提交请求参数：请求数据交换接口的参数，具体的值应符合附录A的要求，所有参数组合应为JSON，加载到请求体（body）,作为请求提交；b)不需要提交请求参数：直接通过请求URL进行访问。5.5响应消息参数要求响应消息格式应为JSON,响应消息参数应包含状态码、状态信息描述和返回数据集。响应消息参数说明见表1。表1响应消息参数说明1235.6接口性能要求应符合如下要求：a)自助终端系统接口服务加载的时间应小于5s；b)接口调用响应时间应小于500ms；c)接口连接超时时间设置不应大于2s。6接口分类自助终端系统接口按服务性质划分为证件读取服务、信息获取服务、打印服务、支付服务、图像服务、声音采集服务、信息提示服务和其它服务。服务通过相应API接口对外提供。接口服务类目见表2。3DB35/T2086—2022表2接口服务类目表123456789writewithdrawCarda)打开设备API,三级类目代码为open；b)关闭设备API,三级类目代码为close。打开设备API和关闭设备API用于打开/关闭相应的设备。4DB35/T2086—20227接口功能要求证件读取服务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的要求。567DB35/T2086—2022接口消息参数各接口请求消息参数和返回数据集见表A.1～表A.32。表A.1读取居民身份证信息API请求消息参数110：否，1：是表A.2读取居民身份证信息API返回数据集1 2—32—4—586—78889—— 表A.3读取出入境证件信息API返回数据集182—3—4—5862—788—8表A.4指纹采集API返回数据集1—2——表A.5指纹比对API请求消息参数1—2—31表A.6指纹比对API返回数据集13 21表A.7读条形码API返回数据集1——表A.8开始签名API返回数据集112—表A.9结束签名API返回数据集11表A.10获取设备信息API请求消息参数1—9DB35/T2086—2022表A.11获取设备信息API返回数据集1—2—表A.12获取设备硬件能力API返回数据集11234516789表A.13获取普通打印机状态API返回数据集12表A.14打印文件API请求消息参数1是），表A.15打印文件API返回数据集11表A.16凭条打印内容API请求消息参数1213343516171810：否，1：是912—3表A.17切纸API请求消息参数11表A.18读取银行卡API返回数据集1 表A.19读取按键值API返回数据集16DB35/T2086—2022表A.20双目摄像头拍照API返回数据集12—210：否，1：是3—4width3 53—64—表A.21高拍仪拍照API返回数据集1—23—3width3—43 表A.22人像比对API请求消息参数1 2—表A.23人像比对API返回数据集13—2—310：否，1：是表A.24图像裁剪API请求消息参数112—表A.25图像裁剪API返回数据集1 表A.26开始录音API请求消息参数1—表A.27指示灯状态设置API请求消息参数1221表A.28人体感应传感器API返回数据集11表A.29温湿度传感器API返回数据集14，224，2表A.30振动传感器API返回数据集14，2—表A.31开始播放API请求消息参数1 表A.32打开软键盘API请求消息参数123—33—DB35/T2086—2022数据字典数据字典见表B.1～表B.6。表B.1返回状态码01表B.2出入境证件类型表B.3普通打印机状态码012345678表B.4密码键盘按键识别码0123456789表B.5灯控板灯序12346789表B.6软键盘类型DB35/T2086—2022参考文献[1]《国务院办公厅关于印发“互联网+政务服务”技术体系建设指南的通知》（国办函〔2016〕[2]