《海南省建筑工地施工现场人员(农民工)实名制监督管理系统(二期)》
数据接口协议
目录
3方案概述PAGEREF _Toc519545886 \h1
4采集设备(https协议)PAGEREF _Toc519545887 \h2
4.1接口描述PAGEREF _Toc519545888 \h2
4.2请求方式PAGEREF _Toc519545889 \h2
4.3请求地址PAGEREF _Toc519545890 \h2
4.4请求参数PAGEREF _Toc519545891 \h2
4.5返回值PAGEREF _Toc519545892 \h3
5.4.4 请求参数PAGEREF _Toc519545922 \h100
5.4.5 返回值PAGEREF _Toc519545923 \h100
5.5设备操作后回馈消息给服务端PAGEREF _Toc519545924 \h111
5.5.1 请求方式PAGEREF _Toc519545925 \h111
5.5.2 请求地址PAGEREF _Toc519545926 \h122
5.5.3 接口调用实例PAGEREF _Toc519545927 \h122
本规范适用于以接口方式,实名制注册和考勤设备对接实名制监管系统,适合在海南备案登记的所有实名制设备厂商。
实名制采集、考勤设备应直接与实名制监管系统对接,不允许通过第三方平台转送(发)实名制管理数据。
为实现劳务人员信息、考勤信息的标准化采集和全省统一应用,制定本数据接口。
本接口方案主要实现采集设备上传采集的劳务人员信息到实名制监管系统,以及考勤设备从实名制监管系统获取人员信息,并上传考勤数据至实名制监管系统。采集设备和考勤设备与实名制监管系统通讯支持https协议。
上传实名认证后的注册人员信息,参数放在body中。
Post请求
https://xxx.xxx.xx.xxx:xxxx/Regist.Asfx/
详细数据,post参数(form-data):
序号 | 参数 | 类型 | 描述 |
1 | Idno | string | 身份证号 |
2 | Name | string | 姓名 |
3 | gender | int | 性别(1:男,2:女) |
4 | nation | string | 民族 |
5 | birthday | string | birthday:出生日期(yyyy-MM-dd) |
6 | address | string | 住址 |
7 | idphoto | string | 身份证照片(base64) |
8 | idphoto1 | string | 身份证正面照片(base64) |
9 | idphoto2 | string | 身份证反面照片(base64) |
10 | photo | string | 现场人员可见光照片(base64) |
11 | idissue | string | 发证机关 |
12 | idperiod | string | 证件有效期,格式:20010101-20110101 |
13 | userType | int | 注册人员类型(1:采集劳务人员,2:采集岗位人员) |
14 | dev_mac | string | 设备序列号 |
15 | RegType | int | 注册类型(1:虹膜采集,2:IC卡(仅用于在系统备案的特殊人群),3;人脸采集,4;虹膜和人脸采集。 (注:系统默认为4) |
返回值(application/json):
序号 | 参数 | 类型 | 描述 |
1 | errcode | int | 成功返回0,失败或错误返回非0的值 |
2 | errmsg | string | 接口调用失败或错误时,返回相应的提示信息 |
返回值示例:
{
"errcode": 0,
"errmsg": "",
}
1) 使用的通讯协议(https)
2) 请求返回结果
{
Result: // 返回请求结果类型
Content: // 返回详细内容,json格式
Msg: // 返回消息
}
3) 为了保证传输过程中的数据安全,返回结果中Content包体数据设定为使用DES进行加密。
4) 字符编码格式UTF-8。
Get请求
https://xxx.xxx.xx.xxx:xxxx/httpserver/Service/DevivePacketWebSvr.assx /GetAddPerson
https://xxx.xxx.xx.xxx:xxxx/httpserver/Service/DevivePacketWebSvr.assx/GetAddPerson?sn=设备序列号
序号 | 参数 | 类型 | 说明 |
1 | sn | string | 设备序列号 |
格式:
{
Result: // 返回请求类型
Content: // 返回内容
Msg: // 返回消息
}
说明:
序号 | 参数 | 类型 | 说明 | |||||||||||||||||||||||||||||||||||
1 | Result | int | 返回类型: -2(设备序列号不存在),-1(服务器异常-失败), 0(空闲-成功) | |||||||||||||||||||||||||||||||||||
2 | Content | string | 返回内容: Content里面的内容用DES加密 deskey:对接的时候提供 加密前格式: [ {“user_id”:””,“name”:””,”work_sn”:””,“iris_template”:””,“ic”:””,”id”:””,“id_card”:””,”iris_count”:1,”enroll_type”:””,“face_template”:””},... ] 数据说明:
| |||||||||||||||||||||||||||||||||||
3 | Msg | string | 返回消息 |
Post请求
https://xxx.xxx.xx.xxx:xxxx/httpserver/Service/DevivePacketWebSvr.assx/UploadAttendance
https://xxx.xxx.xx.xxx:xxxx/httpserver/Service/DevivePacketWebSvr.assx/UploadAttendance?sn=设备序列号&content=考勤数据(des加密后)
序号 | 参数 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||||
1 | sn | string | 设备序列号 | ||||||||||||||||||||||||||||||||||||||||
2 | content | string | 请求内容: json数组 Content里面的内容用des加密 deskey: 对接的时候提供 加密前格式: { Count:2, logs:[ {“sn”:””,”user_id”:””,”recog_time”:””, “recog_type”:”iris”}, {“sn”:””,”user_id”:””,”recog_time”:””, “recog_type”:”iris”}] } 数据说明: Count 数量小于5条
| ||||||||||||||||||||||||||||||||||||||||
格式:
{
Result: // 返回请求类型
Content: // 返回内容
Msg: // 返回消息
}
说明:
序号 | 参数 | 类型 | 说明 |
1 | Result | int | 返回类型: -3(考勤数据为空),-2(设备序列号不存在), -1(服务器异常-失败), 0(空闲-成功) |
2 | Content | string | 返回内容: 空 |
3 | Msg | string | 返回消息 |
Get请求
https://xxx.xxx.xx.xxx:xxxx/httpserver/Service/DevivePacketWebSvr.assx/GetDelPerson
https://xxx.xxx.xx.xxx:xxxx/httpserver/Service/DevivePacketWebSvr.assx/GetDelPerson?sn=设备序列号
序号 | 参数 | 类型 | 说明 |
1 | sn | string | 设备序列号 |
格式:
{
Result: // 返回请求类型
Content: // 返回内容
Msg: // 返回消息
}
说明:
序号 | 参数 | 类型 | 说明 | ||||||||||||||||||||
1 | Result | int | 返回类型: -2(设备序列号不存在), -1(服务器异常-失败), 0(空闲-成功) | ||||||||||||||||||||
2 | Content | string | 返回内容: Content里面的内容用DES加密 deskey: 对接的时候提供 加密前格式: [ {“type”:0,”user_id”:””,“time”:””} ] 数据说明:
| ||||||||||||||||||||
3 | Msg | string | 返回消息 |
Post请求
https://xxx.xxx.xx.xxx:xxxx/httpserver/Service/DevivePacketWebSvr.assx /FeedBack
https://xxx.xxx.xx.xxx:xxxx/httpserver/Service/DevivePacketWebSvr.assx/FeedBack?type=反馈类型&sn=设备序列号&msg=反馈消息
序号 | 参数 | 类型 | 说明 |
1 | type | int | 反馈类型: 0-人员删除成功, 1-人员删除失败, 2-人员下发成功, 3-人员下发失败 |
2 | sn | string | 设备序列号 |
3 | msg | string | 反馈消息内容 |
格式:
{
Result: // 返回请求类型
Content: // 返回内容
Msg: // 返回消息
}
说明:
序号 | 参数 | 类型 | 说明 |
1 | Result | int | 返回类型: -3(反馈类型不能为空),-2(设备序列号不存在), -1(服务器异常-失败), 0(空闲-成功) |
2 | Content | string | 返回内容: 空 |
3 | Msg | string | 返回消息 |
部分内容由用户投稿或者来源于网络,如有侵权,请联系底部邮箱进行删除!非常感谢您的支持!