广东省交通建设工程从业人员实名制管理系统考勤设备功能要求

附件1广东省交通建设工程从业人员实名制管理系统考勤设备功能要求版本：V1.01设备清单 序号 设备 用途 1 闸机 主要用于省内高速公路隧道施工现场与工人学校考勤。根据有关规定，配置要求如下：隧道施工现场的考勤设备为必须配置，至少配备1套闸机、人脸识别设备和身份证读卡器。工人学校、除隧道外的其他施工现场的考勤设备的配置不作强制要求，由各高速公路参建单位自行决定是否配置。 2 人脸识别设备(配合闸机使用) 3 身份证读卡器(配合闸机使用) 2人脸识别设备功能要求⑴识别精准快速，识别速度≤2S，通过率高于99%；⑵满足户外使用环境，防水防尘；⑶支持以太网、wifi、4G等通讯模块；⑷能够自动对眼镜、安全帽、光线和脸部灰层等外部因素进行识别；⑸具有活体检测功能，能够识别相片、视频、面具等伪装素材；⑹单机存储容量大于等于5000人；⑺支持断网本地存储和联网续传；⑻满足与闸机通道联动要求；⑼考勤数据远程上传，上传延时不超过10秒钟；⑽考勤数据本地存储30天以上；⑾满足《广东省交通建设工程从业人员实名制管理系统作业工人信息采集和考勤数据接口标准》中的考勤设备数据规范；⑿满足中华人民共和国电子行业标准《人脸识别设备通用规范》（SJ/T11608-2016）等相关标准要求；⒀支持二次开发。附件2广东省交通建设工程从业人员实名制管理系统信息采集和考勤数据接口规范版本：V1.0技术支持单位：广东诚泰交通科技发展有限公司联系人：黄耀珍联系电话：13802543401目录1引言91.1编写目的91.2适用范围92开发规范92.1通信协议92.2通信安全9102.3注意事项103接口说明11接口说明11请求参数11响应参数11接口说明11请求参数12响应参数12接口说明12请求参数12响应参数13接口说明13请求参数13响应参数13接口说明14请求参数14响应参数14接口说明14请求参数15响应参数15接口说明15请求参数16响应参数16接口说明16请求参数16响应参数164附录164.1测试环境174.2结果码对照表174.3调用示例1引言1.1编写目的为便于广东省交通建设工程从业人员实名制管理系统（以下简称实名制系统）顺利、准确获取通过硬件设备（如：人脸采集设备）采集的人脸信息，特制定本接口规范，也即开发需求说明文档。本标准可用于指导基于实名制系统的各类开发、测试工作，以及作为硬件平台方接入实名制系统的开发指引。1.2适用范围本规范的适用对象为接入实名制管理系统的相关信息采集硬件提供商的技术开发人员和日常维护人员。2开发规范2.1通信协议·采用HTTP（或HTTPS）协议进行请求和响应的处理。接口请求采用GET/POST方式。接口响应返回JSON格式的数据。·由“实名制系统”提供接口地址，以供其他人脸信息采集系统调用，并上报采集的信息和使用用户的考勤信息。·接口请求URL地址：详见接口说明。·接口未注明处均使用UTF-8编码。·通信过程中涉及的中文或特殊符号的传输，需进行urlencode处理。·HTTP（或HTTPS）请求参数均为字符串。·接口请求需进行签名，详见2.2通信安全一节。2.2通信安全为保证数据传输过程中的数据真实性，我们需要对数据进行数字签名，在接收签名数据之后进行签名校验。实名制系统会为每个硬件设备提供商分配唯一的接入编号和接入密钥。签名机制如下：·对全部有长度限制的传输字段（不包括NL类型的字段）进行签名，将参数名（区分大小写）和参数值（需进行urlencode处理）用“=”连接，参数值为空的参数不参与签名，参数之间用“&”连接，格式是：param1=val1&param2=val2…。·参数组装顺序规则：参数名的字典顺序。·密钥拼接方式为传输参数直接连接密钥，如只有param1和param2两参数，值分别为val1和val2，密钥为key，拼接结果为：param1=val1&param2=val2key。·使用“实名制系统”分配的密钥进行MD5加密（密钥直接跟在组装好的参数后即可），将值赋给sign参数。·敏感信息身份证号使用DES加密，加密key等于接入密钥，加密后的字节码转为16进制编码的字符串，并在密文字符串的前面加“des:”前缀。算法：密文=”des:”+HEX(DES(idcard,key))，如：身份证号：5113011990010181111，接入密钥：8c2da4c769828fcfa77aedb690999cf9，密文：des:80cfe03525bb2b8d43d62ff369e95334cd1facfe4bbb800c2.3注意事项·接口中各项参数当标识是M时参数必选，为O时可选。·接口字段长度分为三种：无限制（NL），固定长度（FL），可变长度（VL）。如果为FL，则长度必须精确到FL后跟随的数字，格式举例FL14；如果为VL，则长度在可变范围内即可，如果长度不够，不补空格或其它字符，格式举例VL30。·接口说明中，若参数字体为红色，请仔细阅读备注说明。·请求返回结果码不为0时，需要再次提交请求。如果结果码大于0，则需要根据提示信息修改错误后再次提交；如果结果码小于0，可以间隔一段时间再提交（如：选择间隔5分钟、10分钟、30分钟、1小时提交一次，连续5次提交不成功时推迟到第二天再提交）。3接口说明1）所有接口响应的返回信息均以JSON字符串形式返回，可以使用JSON工具包对其进行解析。2）返回信息具体字段参照接口说明中的响应参数，以下以举例：a）处理成功：{"resultCode":0,"resultDesc":"处理成功"}b）处理失败：{"resultCode":1,"resultDesc":"签名错误"}返回结果码对照见附录4.2结果码对照表3.1实时上报工人人脸信息接口说明 接口描述 工人人脸信息采集 请求地址 测试请求地址 http://59.42.52.229:81/realnameplatform/rn/realnamemanagement/extramessage/facerecognition/save.action请求参数 参数 限制 长度 注释 备注 accessNo M FL32 接入编号 “实名制系统”为施工企业分配的接入编号 idCardNo M VL150 工人身份证号 检查工人是否存在的依据，使用DES加密 collectTime M VL50 信息采集时间 yyyyMMddHHmmss faceImage M NL 人脸采集图片 取图片的二进制值，转成base64编码。不参与签名 equipmentNo O VL32 采集设备编号 区分采集设备上传厂商 timestamp M VL50 时间戳 yyyyMMddHHmmssSSS sign M VL32 签名 faceImage不参与签名响应参数 参数 限制 说明 resultCode M 返回结果码，数字类型。0表示成功；其它表示失败。 resultDesc O 返回结果描述3.2实时上报工人考勤信息接口说明 接口描述 实时上报工人考勤信息 请求地址 测试请求地址 http://59.42.52.229:81/realnameplatform/rn/workattendance/save.action请求参数 参数 限制 长度 注释 备注 accessNo M FL32 接入编号 “实名制系统”为施工企业分配的接入编号 idCardNo M VL150 工人身份证号 检查工人是否存在的依据，使用DES加密 atteTime M VL50 考勤时间 yyyyMMddHHmmss atteType M FL1 考勤方式 2:人脸0=上班, 1=下班 atteChannel M VL150 考勤通道名称 如有多个考勤机、闸机，上传其考勤通道名称（1号，2号，3号…） factoryNum M VL20 考勤机厂家编号 平台分配给厂商的识别编号，区分考勤机上传厂商 timestamp M VL50 时间戳 yyyyMMddHHmmssSSS sign M VL200 签名 响应参数 参数 限制 说明 resultCode M 返回结果码，数字类型。0表示成功；其它表示失败。 resultDesc O 返回结果描述3.3批量上报工人考勤信息接口说明 接口描述 批量上报工人考勤信息 请求地址 测试请求地址 http://59.42.52.229:81/realnameplatform/rn/workattendance/saves.action请求参数 参数 限制 长度 注释 备注 accessNo M FL32 接入编号 “实名制系统”为施工企业分配的接入编号 dataList M NL 考勤数据列表 考勤数据列表。不参与签名。json格式的数据：[{idCardNo:‘工人身份证号，使用DES加密’,workDate:‘考勤时间，格式yyyyMMddHHmmss’,workStart:‘上班时间，格式yyyyMMddHHmmss’,workEnd:‘下班时间，格式yyyyMMddHHmmss’,atteType:’考勤方式’checkChannel:’考勤机通道名称’,}] factoryNum M VL20 考勤机厂家编号 厂商的识别编号，区分考勤机上传厂商 timestamp M VL50 时间戳 yyyyMMddHHmmssSSS sign M VL200 签名 dataList不参与签名响应参数 参数 限制 说明 resultCode M 返回结果码，数字类型。0表示成功；其它表示失败。 resultDesc O 返回结果描述3.4实时上报工人学校培训教育考试签到考勤信息接口说明 接口描述 批量上报工人考勤信息 请求地址 测试请求地址 http://59.42.52.229:81/realnameplatform/rn/trainattendance/saves.action请求参数 参数 限制 长度 注释 备注 accessNo M FL32 接入编号 “实名制系统”为施工企业分配的接入编号 idCardNo M VL150 工人身份证号 检查工人是否存在的依据，使用DES加密 atteTime M VL50 签到时间 yyyyMMddHHmmss checkType M FL1 签到类型 0:签到1:签退 atteType M FL1 签到方式 2:人脸 atteChannel M VL150 签到通道名称 如有多个考勤机、闸机，上传其考勤通道名称（1号，2号，3号…） factoryNum M VL20 签到机厂家编号 厂商的识别编号，区分考勤机上传厂商 timestamp M VL50 时间戳 yyyyMMddHHmmssSSS sign M VL200 签名 响应参数 参数 限制 说明 resultCode M 返回结果码，数字类型。0表示成功；其它表示失败。 resultDesc O 返回结果描述3.5平台提供查询工人部分信息的服务接口接口说明 接口描述 查询工人部分信息的服务接口 请求地址 测试请求地址 http://59.42.52.229:81/realnameplatform/hardware/userinfo/getUserMessage.action请求参数 参数 限制 长度 注释 备注 accessNo M FL32 接入编号 “实名制系统”为施工企业分配的接入编号 idCardNo M VL150 工人身份证号 检查工人是否存在的依据， timestamp M VL50 时间戳 yyyyMMddHHmmssSSS sign M VL200 签名 响应参数 参数 限制 说明 resultCode M 返回结果码，数字类型。0表示成功；其它表示失败。 resultDesc M 返回工人信息，以json数据格式返回。{"assessResult":"100",//考核得分"deptName":"武汉浩隆建筑劳务工程有限公司",//单位名称"trainState":"0",//是否参加岗前培训0-未参加1-已参加"workCategory":"其他",//工种"userName":"张三",//工人或管理员姓名"enterTime":"20190224000000",//进场时间"salaryState":"0",//上个月工资发放情况0-未放发1-已发放"teamMasterName":"张三梁板架设班组",//班组名称"jobPosition":"工人"//职位}3.6平台提供获取工人人脸信息的服务接口接口说明 接口描述 获取工人人脸信息的服务接口 请求地址 测试请求地址 http://59.42.52.229:81/realnameplatform/hardware/faceImage/getImageInfo.action请求参数 参数 限制 长度 注释 备注 accessNo M FL32 接入编号 “实名制系统”为硬件厂商分配的接入编号 timestamp M VL50 时间戳 yyyyMMddHHmmssSSS sign M VL200 签名 响应参数 参数 限制 说明 resultCode M 返回结果码，数字类型。0表示成功；其它表示失败。 resultDesc M 返回工人信息，以json数据格式返回。{"resultCode":0,"resultDesc":{"faceImageInfo":[{"imgStr":"/9j/4AAQSkZJRgABAQAAAQ...";"idCardNo":"35f2057d81f36b5...",//des加密"name":"钱四"}]}}或{"resultCode":0,"resultDesc":"系统未新增人脸信息"}3.7上报获取人脸信息记录的服务接口接口说明 接口描述 获取工人人脸信息成功后上报获取记录 请求地址 测试请求地址 http://59.42.52.229:81/realnameplatform/rn/realnamemanagement/extramessage/facerecognitionrecord/saves.action请求参数 参数 限制 长度 注释 备注 accessNo M FL32 接入编号 “实名制系统”为硬件厂商分配的接入编号 dataList M NL 工人身份证号(使用DES加密) 身份证数据列表。不参与签名。json格式的数据：["67f2057d81f36b5..","345f2057d8136b5..","45f2057d8136b5..","15f2057d8136b5.."] timestamp M VL50 时间戳 yyyyMMddHHmmssSSS sign M VL200 签名 响应参数 参数 限制 说明 resultCode M 返回结果码，数字类型。0表示成功；其它表示失败。 resultDesc M 返回结果描述3.8平台推送工人人脸信息的服务接口接口说明 接口描述 平台采集人脸信息后，向硬件厂商推送工人人脸信息 推送地址 测试推送地址 由硬件厂商提供请求参数 参数 限制 长度 注释 备注 userName M VL50 用户姓名 工人或管理人员姓名 idCardNo M VL50 身份证号码 使用DES加密 imgStr M NL 人脸图片 取图片的二进制值，转成base64编码。不参与签名 timestamp M VL50 时间戳 yyyyMMddHHmmssSSS sign M VL200 签名 响应参数 参数 限制 说明 resultCode M 返回结果码，数字类型。0表示成功；其它表示失败。 resultDesc M 结果描述4附录4.1测试环境测试环境接入编号：1554694859413测试环境接入密钥：ffb8df99fa1d43848c550d3c7f65fd0cidCardNo：360430197109132335,3604301961040823114.2结果码对照表 返回码 返回码文本介绍 说明 0 请求成功 当且仅当返回码为0时，请求成功 1 签名验证失败 签名错误 2 参数错误 参数长度或数据类型错误 3 接入编号错误 接入编号不存在 4 请求超时 请求时间超过5分钟，视为超时 201 工人不存在 添加修改工人证书、添加修改班组工人时返回 202 工人未进场 工人未通过进场申请 203 厂商未关联单位信息 厂商没有关联施工或用工单位 204 身份证号不能为空 上报获取人脸信息记录的身份证参数不能为空 301 培训计划不存在 工人所在施工单位未开启培训计划 401 图片转换失败 人脸base64字符串转换成图片出错 -1 系统内部异常:[..],请稍候再试 系统内部异常，返回异常描述4.3调用示例4.3.1将参数排序(以JavaTreeMap实现参数名按ASCII字典顺序排序)TreeMap<String,String>params=newTreeMap<>();params.put(“param1”,urlencode(“value1”,“UTF-8”));params.put(“param2”,urlencode(“value2”,“UTF-8”));4.3.2将参数拼接成字符串(空值不参与签名)Stringstr="";for(param:params){if(param.value!=null&&param.value.length()>0){str+="&"+param.key+"="+param.value;}}str=str.substring(1,str.length());4.3.3生成签名Stringsign=md5(str+key);params.put("sign",sign);4.3.4提交数据http.post(params);附件3申请函广东省交通运输厅：我公司现向你厅申请加入广东省交通建设工程从业人员实名制管理系统考勤设备供应商名录，提交相关申请材料，请对我公司服务资格、服务条件、服务承诺等进行核查。专此函达。（联系人:电话:手机:）企业（盖章）：日期：年月日附件4法定代表人授权书广东省交通运输厅：本授权书声明：是注册于（国家或地区）的（公司名称）的法定代表人，现任职务，有效证件号码：。现授权（姓名、职务、有效证件号码）作为我公司的全权代理人，负责处理我公司在广东省交通建设工程从业人员实名制管理系统考勤设备业务的一切事务，我均予以承认。本授权书于年月日签字生效。公司（盖章）：地址：法定代表人（签字或盖章）：被授权人（签字或盖章）：联系手机：附件5承诺书广东省交通运输厅：我公司自愿申请加入广东省交通建设工程从业人员实名制管理系统考勤设备供应商名录，并承诺如下：1、关于诚信守法我公司在进入广东省交通建设工程市场后，将严格遵守国家、广东省有关交通建设工程从业人员实名制管理的法律、法规、规章和有关规定，全面履行各项应尽的义务，自觉接受广东省交通运输（含港口、港务）主管部门的监管。我司提供到交通建设工程施工现场的信息采集及考勤设备均符合广东省实名制监管功能要求和数据规范标准。2、关于申请材料我公司所提交申请材料都是真实的、准确的，并对按要求提供的各项资料的原件和填报数据的真实性负责，若有违背，自愿接受主管部门给予的处理和限制市场准入的处理。3、关于数据安全我公司接入到广东省交通建设工程从业人员实名制管理系统的采集及考勤设备均符合国家及广东省相关法律、法规、标准规范等规定的安全要求；对于设备采集的数据，我公司将采取必要的技术手段保障数据的安全性，如是我公司原因导致数据外泄，我公司将承担相应法律责任。4、关于售前售后服务（一）我公司所提供的采集及考勤设备均已按要求接入广东省交通建设工程从业人员实名制管理系统，并经调试测试满足广东省交通建设工程实名制管理要求；（二）我公司将按国家相关法律法规要求提供必要的售后服务，包括但不限于设备的运输、安装、调试、保修服务；（三）设备安装到工地后，我公司司将协助施工单位将设备接入实名制系统，并提供必要的实地培训及设备操作手册，保证使用人员尽快熟悉设备操作流程，确保各项数据及时、准确传入实名制管理系统。五、关于不符合要求的处置我公司将严格遵守本承诺，不断提升服务质量，及时处理用户投诉。有关管理部门及其授权机构根据相关管理规定，要求我公司限期改进服务的，我公司承诺按时改进服务直至满足要求；逾期没有满足要求的，同意依据法律法规和承诺事项将我公司从广东省交通建设工程从业人员实名制管理系统考勤设备供应商名录中清出。本承诺书自法定代表人或其授权代表签字之日起生效。特此承诺。企业（盖章）：法定代表人（签字）：日期：年月日 精心整理，仅供参考编辑文案使用，请按实际需求再行修改编辑 2020年2月