广州建设领域管理应用信息平台.docx
《广州建设领域管理应用信息平台.docx》由会员分享,可在线阅读,更多相关《广州建设领域管理应用信息平台.docx(25页珍藏版)》请在冰豆网上搜索。
广州建设领域管理应用信息平台
广州市建设领域管理应用信息平台建筑工人实名制数据接口标准
1
一、引言1
1.1编写目的1
1.2适用范围1
1.3简称和术语1
二、开发规范2
2.1通信协议2
2.2通信安全2
2.3注意事项3
三、接口说明4
3.1新增班组4
3.2修改班组6
3.3添加班组工人7
3.4修改班组工人9
3.5班组工人进退场10
四、附录10
4.1测试环境10
4.2结果码对照表11
4.3工种代码表11
4.4银行代码表11
2
一、引言
1.1编写目的
为实现广州市建设领域管理应用信息平台对项目从业人员实名制管理,考虑到部分项目
已经在使用一些商业化实名制管理系统,为避免数据重复登记、减少系统改造成本,特编写
本接口文档以供施工企业相关技术人员对接。
1.2适用范围
本文档的适用对象为接入广州市建设领域管理应用信息平台的施工企业技术开发人员、
日常维护人员。
1.3简称和术语
广州市建设领域管理应用信息平台:
以下简称“信息平台”
施工企业:
指依法取得施工企业资质证书,在本市从事建设施工活动的施工总承包企业、专
业承包企业和劳务分包企业
1
二、开发规范
2.1通信协议
采用HTTP(或HTTPS)协议进行请求和响应的处理。
接口请求采用GET/POST方式。
接口响应返回JSON格式的数据。
由“信息平台”提供接口地址,企业实名制或考勤系统。
接口请求URL地址:
详见接口说明。
接口未注明处均使用UTF-8编码。
通信过程中涉及的中文或特殊符号的传输,需进行urlencode处理。
HTTP(或HTTPS)请求参数均为字符串。
接口请求需进行签名,详见2.2通信安全一节。
2.2通信安全
为保证数据传输过程中的数据真实性,我们需要对数据进行数字签名,在接收签名数据
之后进行签名校验。
“信息平台”会为施工企业的每个工程分配唯一的接入编号和接入密钥。
签名机制如下:
对全部有长度限制的传输字段(不包括NL类型的字段)进行签名,将参数名(区
分大小写)和参数值(需进行urlencode处理)用“=”连接,参数值为空的参数
不参与签名,参数之间用“&”连接,格式是:
param1=val1¶m2=val2。
参数组装顺序规则:
参数名的字典顺序。
密钥拼接方式为传输参数直接连接密钥,如只有param1和param2两参数,值分
别为val1和val2,密钥为key,拼接结果为:
param1=val1¶m2=val2key。
使用“信息平台”分配的密钥进行MD5加密(密钥直接跟在组装好的参数后即可),
将值赋给sign参数。
敏感信息班组编号、身份证图片路径、身份证号、银行卡号、社保号需要加密传输,
使用DES加密,加密key等于接入密钥,加密后的字节码转为16进制编码的字符
串,并在密文字符串的前面加“des:
”前缀。
算法:
密文=”des:
”+HEX(DES(idcard,key)),如:
身份证号:
5113011990010181111,接入密钥:
8c2da4c769828fcfa77aedb690999cf9,密文:
des:
80cfe03525bb2b8d43d62ff369e95334cd1facfe4bbb800c
2
2.3注意事项
接口中各项参数当标识是M时参数必选,为O时可选。
接口字段长度分为三种:
无限制(NL),固定长度(FL),可变长度(VL)。
如果
为FL,则长度必须精确到FL后跟随的数字,格式举例FL14;如果为VL,则长度在
可变范围内即可,如果长度不够,不补空格或其它字符,格式举例VL30。
接口说明中,若参数字体为红色,请仔细阅读备注说明。
请求返回结果码不为0时,需要再次提交请求。
如果结果码大于0,则需要根据提
示信息修改错误后再次提交;如果结果码小于0,可以间隔一段时间再提交(如:
选择间隔5分钟、10分钟、30分钟、1小时提交一次,连续5次提交不成功时推
迟到第二天再提交)。
3
三、接口说明
所有接口响应的返回信息均以JSON字符串形式返回,可以使用JSON工具包对
其进行解析。
返回信息具体字段参照接口说明中的响应参数,以下以举例:
处理成功:
{"resultCode":
0,"resultDesc":
"处理成功"}
处理失败:
{"resultCode":
1,"resultDesc":
"签名错误"}
返回结果码对照见附录4.2结果码对照表。
3.1新增班组
接口说明
接口描述施工企业添加班组时调用
请求地址/smz/team/save
测试请求地址
请求参数
参数
限制
长度
注释
备注
accessNo
M
FL32
接入编号
“信息平台”为施工企业分配的接入编号
工程内部的班组唯一编码,如果班组编码已存在则
teamCode
M
VL320
班组编码
修改班组。
格式:
班组长身份证号
+班组类型代
码,使用DES加密
name
M
VL40
班组名称
班组命名格式:
班组长姓名+
班组类型+“班
组”
workType
M
VL32
班组类型
参考附录4.3
leaderAppointment
O
VL400
班组长证明书
外网能访问的URL路径,“信息平台”会自动抓取
leaderIdcard
M
VL150
工人身份证号
检查工人是否存在的依据,使用DES加密
leaderName
M
VL30
工人姓名
leaderSex
M
FL1
性别
M:
男F:
女
leaderNation
M
VL40
民族
leaderBirthday
M
FL8
生日
yyyyMMdd
4
leaderAddress
M
VL400
leaderSignOrgan
M
VL30
leaderExpiryStart
M
FL8
leaderExpiryEnd
O
FL8
leaderHeadImg
O
VL400
leaderIdcardFront
O
VL150
0
leaderIdcardBack
O
VL150
0
leaderCurrentAddress
M
VL400
leaderPolitical
M
FL1
leaderEducation
M
VL32
leaderPhone
M
VL11
leaderEmployType
M
FL1
leaderTechLevel
M
FL1
leaderContractCode
O
VL50
leaderContractFile
O
VL400
leaderCardNum
O
VL150
leaderCardBank
O
VL10
leaderWorkType
M
VL32
leaderSecurityCode
O
VL300
leaderSafetyEdu
M
FL1
leaderSafetyEduImg
O
VL400
leaderBuilderType
M
FL1
leaderDoDate
M
FL8
timestamp
M
FL17
sign
M
FL32
住址
身份证上的住址
签发机关
身份证的签发机关
有效期开始日期
身份证有效期开始日期
有效期结束日期
身份证有效期结束日期,为空表示长期
身份证头像URL
外网能访问的URL路径,“信息平台”会自动抓取
身份证正面照
外网能访问的URL
路径,“信息平台”会自动抓
取,使用DES加密
身份证反面照
外网能访问的URL
路径,“信息平台”会自动抓
取,使用DES加密
常住地址
近期的常住地址
政治面貌
0:
党员1:
团员2:
群众
文化程度
本科以上、本科、大专、中专、高中、初中及以下
手机号
用工形式
0:
固定工人1:
外聘
技能水平
0:
无(普通);1:
初级工;2:
中级工;3:
高级工;
4:
技师;5:
高级技师
合同编号
施工企业内部的合同编号。
合同附件
外网能访问的URL路径,“信息平台”会自动抓取。
工资卡账号
使用DES加密
工资卡开户行代
参考附录4.4
码
工种代码
参考附录4.3
社保号
使用DES加密
是否参加安全教
true:
是;false:
否
育
安全教育图片
外网能访问的URL路径,“信息平台”会自动抓取。
工人类型
0:
建筑工匠;1:
建筑产业技术工人;2:
其他
进场日期
yyyyMMdd
时间戳
北京时间精确到毫秒(yyyyMMddHHmmssSSS)
签名
响应参数
参数限制说明
5
resultCodeM返回结果码,数字类型。
0表示成功;其它表示失败。
resultDescO返回结果描述
3.2修改班组
接口说明
接口描述施工企业修改班组时调用
请求地址/smz/team/update
测试请求地址
请求参数
参数限制长度
accessNoMFL32
teamCodeMVL320
name
M
VL40
workType
M
VL32
leaderAppointment
O
VL400
leaderIdcard
M
VL150
leaderCurrentAddress
M
VL400
leaderPolitical
M
FL1
leaderEducation
M
VL32
leaderPhone
M
VL11
leaderEmployType
M
FL1
leaderTechLevel
M
FL1
leaderContractCode
O
VL50
leaderContractFile
O
VL400
leaderCardNum
O
VL150
leaderCardBank
O
VL10
leaderWorkType
M
VL32