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

ICS01.040.35CCSL72ICS01.040.35CCSL72福 建 省 地 方 标 准DB35/T2086—2022政务服务自助终端系统接口要求Governmentservices—Self-serviceterminalsysteminterfacerequirements2022-10-27发布 2023-01-27实施福建省场监理局 发布DB35/T2086DB35/T2086—2022DB35/T2086DB35/T2086—2022IIIIII目 次前言 II范围 1规范性引用文件 1术语和定义 1缩略语 1总体要求 1接口分类 2接口功能要求 4附录A（规范性）接口消息参数 7附录B（资料性）数据字典 13参考文献 15前 言本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由福建省经济信息中心提出。本文件由福建省信息化标准化技术委员会（SAFJ/TC11）归口。本文件起草单位：福建省经济信息中心、厦门市行政审批管理局、厦门熙重电子科技有限公司、职业学院。本文件主要起草人：俞希标、张瑞、林铃、王秀云、黄柳铃、黄条文、张建国、王翔龙、巩福。DB35/T2086DB35/T2086—2022DB35/T2086DB35/T2086—2022PAGEPAGE7PAGEPAGE6政务服务自助终端系统接口要求范围本文件适用于政务服务自助终端接入各级政府部门政务服务应用的系统接口开发、管理工作。规范性引用文件（包括所有的修改单适用于本文件。GB/T39735政务服务评价工作指南术语和定义GB/T39735界定的以及下列术语和定义适用于本文件。3.1自助终端self-serviceterminal面向自然人、法人和其他组织提供多部门政务服务应用的自助办理设备。3.2自助终端系统self-serviceterminalsystem安装在自助终端上，用于接入政务服务应用的系统。缩略语下列缩略语适用于本文件。API：应用程序编程接口（ApplicationProgrammingInterface）HTTPS：超文本传输安全协议（HyperTextTransferProtocoloverSecureSocketLayer）JSON：JavaScript对象简普（JavaScriptObjectNotation）MAC：媒体存取控制（MediaAccessControl）REST：表述性状态传递（RepresentationalStateTransfer）URL：统一资源定位符（UniformResourceLocator）总体要求数据交换方式数据交换接口应以REST架构的APIHTTPS数据交换消息要求数据交换接口消息应采用JSON字符串，以键值对（key-value）的形式封装。消息请求及响应参数的英文名为JSON键值对的键名（key）。消息编码格式采用UTF-8。URLURLhtts:/1270.01:801/示例：读取居民身份证信息API调用地址：:8801/idcardManage/read请求消息参数要求应符合如下要求：AJSON，加载到请求体（body）,作为请求提交；URL响应消息参数要求响应消息格式应为JSON,响应消息参数应包含状态码、状态信息描述和返回数据集。响应消息参数说明见表1。表1响应消息参数说明序号参数参数名称类型类型名称参数说明1code状态码Int整型详见附录B中的表B.12msg状态信息描述String字符串返回情况描述信息3data返回数据集Object对象返回的数据结果集，采用JSON字符串表示；若需要返回数据集，应符合附录A的要求接口性能要求应符合如下要求：5s；500ms；2s。接口分类接口服务类目见表2。表2接口服务类目表序号一级类目二级类目二级类目代码三级类目三级类目代码1证件读取服务居民身份证读卡器idcardManage读取居民身份证信息APIread2出入境证件识读器crjcardManage读取出入境证件信息APIread3信息获取服务指纹仪fingerManage指纹采集APIfingerprInt4指纹比对APIvalidateFingerPrInt5条形码扫描器erCodeManage读条形码APIread6签字屏signManage开始签名APIstartSignature7结束签名APIstopSignature8设备信息deviceManage获取设备信息APIgain9获取设备硬件能力APIgainAbility10打印服务普通打印机printManage获取普通打印机状态APIgetStatus11打印文件APIprintFile12凭条打印机receiptPrintManage凭条打印内容APIwrite13切纸APIprintCutpaper14支付服务银行读卡器bankCardManange读取银行卡APIread15退出银行卡APIwithdrawCard16密码键盘eppManage读取按键值APIscanKeyPress17图像服务双目摄像头blCameraManage双目摄像头拍照APIlivingBodyDetect18人像比对APIfaceComp19高拍仪photographManage高拍仪拍照APIphotoGraph20图像处理imgprocessManage图像裁剪APIsmartCutOut21声音采集服务拾音器pickupManage开始录音APIopenMic22结束录音APIcloseMic23信息提示服务指示灯控设备ledManage指示灯状态设置APIsetLedStatus24传感器sensorManage人体感应传感器APIbodySensor25温湿度传感器APItempAndHumiditySensor26振动传感器APIvibrationSensor27语音提示ttsManage开始播放APIspeak28停止播放APIstop29其它服务软键盘keyboardManage打开软键盘APIopen30关闭软键盘APIcloseAPIopen；APIclose。打开设备API和关闭设备API用于打开/关闭相应的设备。接口功能要求证件读取服务API用于读取居民身份证信息，并返回姓名、证件号码、出生日期等信息，请求消息参数应符合附录A中表A.1的要求,返回数据集应符合附录A中表A.2的要求。API信息获取服务APIA中表A.4的要求。APIAPI用于读取一维条码和二维条码，并返回相应的条形码值，返回数据集应符合附录A中表A.7的要求。API用于开始记录签名信息，并返回签字屏状态、签名图片等信息，返回数据集应符合附录A中表A.8的要求。API用于结束签名，返回数据集应符合附录A中表A.9的要求。APIIDMACA中表A.10的要求，返回数据集应符合附录A中表A.11的要求。API用于获取设备硬件能力，可以返回设备支持的硬件能力信息，返回数据集应符合附录A中表A.12的要求。打印服务API用于获取普通打印机的状态信息，返回数据集应符合附录A中表A.13的要求。API用于发送文件给普通打印机进行打印，并返回打印执行结果信息，请求消息参数应符合附录A中表A.14的要求,返回数据集应符合附录A中表A.15的要求。APIAPI用于发送切纸方式来触发凭条打印机进行切纸，请求消息参数应符合附录A中表A.17的要求。支付服务API用于读取银行卡信息，并返回银行卡号等信息，返回数据集应符合附录A中表A.18的要求。API用于让银行读卡器退出银行卡。API用于读取密码键盘的按键值，返回数据集应符合附录A中表A.19的要求。图像服务API用于使用双目摄像头进行拍照，并返回照片信息，返回数据集应符合附录A中表A.20的要求。API用于使用高拍仪进行拍照，并返回照片信息,返回数据集应符合附录A中表A.21的要求。API用于人像照片比对，并返回活体分数、比对结果等信息，请求消息参数应符合附录A中表A.22的要求,返回数据集应符合附录A中表A.23的要求。API用于对采集的图像进行裁剪，请求消息参数应符合附录A中表A.24的要求,返回数据集应符合附录A中表A.25的要求。声音采集服务API用于触发拾音器开始录音，并把录音文件保存在指定路径，请求消息参数应符合附录A中表A.26的要求。API用于触发拾音器结束录音。信息提示服务API用于设置指示灯控设备的状态，请求消息参数应符合附录A中表A.27的要求。API用于获取人体感应传感器状态，返回是否有人等信息，返回数据集应符合附录A中表A.28的要求。API用于获取温湿度传感器的状态，返回温度、湿度等信息，返回数据集应符合附录A中表A.29的要求。API用于获取振动传感器的状态，返回振动强度等信息，返回数据集应符合附录A中表A.30的要求。API用于通过扬声器播放指定的提示语，请求消息参数应符合附录A中表A.31的要求。API用于触发扬声器停止播放。其它服务API用于打开软键盘，请求消息参数应符合附录A中表A.32的要求。API用于关闭软键盘。附录 A（规范性）各接口请求消息参数和返回数据集见表A.1～表A.32。表A.1读取居民身份证信息API请求消息参数序号参数参数名称类型长度备注1finger是否获取指纹Int10：否，1：是A.2API序号参数参数名称类型长度备注1name姓名String50—2nation民族String40—3sex性别String2—4docNo证件号码String18—5birth出生日期String8日期格式：YYYYMMDD6address户籍地址String100—7startDate有效起始时间String8日期格式：YYYYMMDD8endDate有效截止时间String8日期格式：YYYYMMDD9regOffice签发机关String100—10photo头像图片String—base64字符串11fingerImg指纹图片String—base64字符串A.3API序号参数参数名称类型长度备注1docType证件类型String8详见附录B中的表B.22docNo证件号码String18—3chiName中文姓名String70—4engName英文姓名String70—5birth出生日期String8日期格式：YYYYMMDD6sex性别String2—7expire有效期String8日期格式：YYYYMMDD8photo照片base64字符串String—base64字符串DB35/T2086—2022DB35/T2086—2022DB35/T2086DB35/T2086—2022PAGEPAGE14PAGEPAGE15表A.4指纹采集API返回数据集序号参数参数名称类型长度备注1imgData指纹图片字符串String—base64字符串2features指纹特征字符串String——表A.5指纹比对API请求消息参数序号参数参数名称类型长度备注1fingerData1待比对的指纹数据1String—特征值字符串或指纹图片base64字符串，具体依据type值来定2fingerData2待比对的指纹数据2String—3type比对类型Int10：特征值比对，1：图片比对A.6API序号参数参数名称类型长度备注1score比对分数Int3—2result比对结果Int10：同一人，1：非同一人A.7API序号参数参数名称类型长度备注1result扫描内容String——A.8API序号参数参数名称类型长度备注1result签字屏状态Int11：正在签名，2：签名结束，3：用户取消签名2image签名图片String—base64字符串A.9API序号参数参数名称类型长度备注1result操作结果Int10：成功，其它：失败表A.10获取设备信息API请求消息参数序号参数参数名称类型长度备注1moduleCode事项编码String40—表A.11获取设备信息API返回数据集序号参数参数名称类型长度备注1deviceId设备idString32—2macAddress设备mac地址String17—表A.12获取设备硬件能力API返回数据集序号参数参数名称类型长度备注1readIdCard读取居民身份证信息Int10：不支持，1：支持2readCrjCard读取出入境证件信息3fingerprInt指纹采集4validateFingerPrInt指纹比对5readErCode读取条形码Int10：不支持，1：支持6sign签字7printFile打印文件8receiptPrint打印凭条9printCutpaper凭条切纸10readBankCard读取银行卡11eppManage密码键盘12livingBodyDetect双目摄像头拍照13faceComp人像比对14smartCutOut图像裁剪15photoGraph高拍仪拍照16pickupManage录音17ledManage指示灯18bodySensor人体感应传感器19tempAndHumiditySensor温湿度传感器20vibrationSensor振动传感器21ttsManage语音提示22keyboard软键盘表A.13获取普通打印机状态API返回数据集序号参数参数名称类型长度备注1status打印机状态码Int2详见附录B中的表B.3表A.14打印文件API请求消息参数序号参数参数名称类型长度备注1path打印文件绝对路径String是C:/file.pdf，或者为文件下载URL（以http开头）表A.15打印文件API返回数据集序号参数参数名称类型长度备注1result执行结果Int10：正常，1：失败表A.16凭条打印内容API请求消息参数序号参数参数名称类型长度备注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走纸行数Int2—11leftmargin左边距Int3取值0-576，单位0.125mm表A.17切纸API请求消息参数序号参数参数名称类型长度备注1prIntCutpaper切纸方式Int1默认为0，0：全切，1：半切A.18API序号参数参数名称类型长度备注1cardNum银行卡卡号String19—A.19API序号参数参数名称类型长度备注1keyValue按键识别码String6详见附录B中的表B.4表A.20双目摄像头拍照API返回数据集序号参数参数名称类型长度备注1score活体分数Int2—2result是否为活体Int10：否，1：是3livePhoto活体图像String—base64字符串4width宽度Int3—5height高度Int3—6dpi分辨率Int4—A.21API序号参数参数名称类型长度备注1imgData图片String—base64字符串2dpi分辨率Int3—3width宽度Int3—4height高度Int3—A.22API序号参数参数名称类型长度备注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字符串表A.26开始录音API请求消息参数序号参数参数名称类型长度备注1filename录音文件存放路径String200—表A.27指示灯状态设置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.30API序号参数参数名称类型长度备注1status振动强度Float4，2—A.31API序号参数参数名称类型长度备注1info提示语String100—表A.32