广州市建设领域管理应用信息平台.docx
- 文档编号:27559906
- 上传时间:2023-07-02
- 格式:DOCX
- 页数:20
- 大小:21.92KB
广州市建设领域管理应用信息平台.docx
《广州市建设领域管理应用信息平台.docx》由会员分享,可在线阅读,更多相关《广州市建设领域管理应用信息平台.docx(20页珍藏版)》请在冰豆网上搜索。
广州市建设领域管理应用信息平台
广州市建设领域管理应用信息平台
建筑工人实名制数据接口标准
一、弓I言1
二、开发规范2
三、接口说明
4
10
四、附录
一、引言
1・1编写目的
实现广州市建设领域管理应用信息平台对项目从业人员实名制管理,考虑到部分项目已经在使用一些商业化实名制管理系统,为避免数据重复登记、减少系统改造成本,特编写本接II文档以供施工企业相关技术人员对接。
1・2适用范围
文档的适用对彖为接入广州市建设领域管理应用信息平台的施工企业技术开发人员、口常维护人员。
1.3简称和术语
广州市建设领域管理应用信息平台:
以下简称“信息平台”
施工企业:
指依法取得施工企业资质证书,在本市从事建设施工活动的施工总承包企业、专
业承包企业和劳务分包企业
二、开发规范
2.1通信协议
•采用HTTP(或HTTPS)协议进行请求和响应的处理。
接II请求采用GET/POST方式。
接II响应返回JSON格式的数据。
•由“信息平台”提供接【I地址,企业实名制或考勤系统。
•接II请求URL地址:
详见接口说明。
•接II未注明处均使用UTF-8编码。
•通信过程中涉及的中文或特殊符号的传输,需进行urlencode处理。
•HTTP(或HTTPS)请求参数均为字符串。
•接口请求需进行签名,详见2.2通信安全一节。
2.2通信安全
保证数据传输过程中的数据真实性,我们需要对数据进行数字签名,在接收签名数据之后进行签名校验。
信息平台”会为施工企业的每个工程分配唯一的接入编号和接入密钥。
签名机制如下:
•对全部有长度限制的传输字段(不包括NL类型的字段)进行签名,将参数名(区分大小写)和参数值(需进行urlencode处理)用“=”连接,参数值为空的参数不参与签名,参数之间用“&"连接,格式是:
paramI=vall¶m2=val2…。
•参数组装顺序规则:
参数名的字典顺序。
•密钥拼接方式为传输参数直接连接密钥,如只有param1和param2两参数,值分别为vail和val2,密钥为key,拼接结果为:
paraml=vall¶m2=val2keyo
•使用“信息平台”分配的密钥进行MD5加密(密钥直接跟在组装好的参数后即可),将值赋给sign参数。
•蝕感仁息班组编号、身份证图片路径、身份证号、银行卡号、社保号需要加密传输,使用DES加密,加密key等于接入密钥,加密后的字节码转为16进制编码的字符串,并在密文字符串的前面加"des:
"前缀。
算法:
密文="des:
"+HEX(DES(idcard,key)),如:
身份证号:
5113011990010181111,接入密钥:
8c2da4c769828fcfa77aedb690999cf9,密文:
des:
80cfe03525bb2b8d43d62ff369e95334cdlfacfe4bbb800c
2.3注意事项
•接II中各项参数当标识是M时参数必选,为0时可选。
•接口字段长度分为三种:
无限制(NL),固定长度(FL),可变长度(VL)o如果为FL,则长度必须精确到FL后跟随的数字,格式举例FL14;如果为VL,则长度在可变范闱内即可,如果长度不够,不补空格或其它字符,格式举例VL30。
•接II说明中,若参数字体为红色,请仔细阅读备注说明。
•请求返回结果码不为0时,需要再次提交请求。
如果结果码人于0,则需要根据提示信息修改错误后再次提交;如果结果码小于0,可以间隔一段时间再提交(如:
选择间隔5分钟、10分钟、30分钟、1小时提交一次,连续5次提交不成功时推迟到第二天再提交)。
三、接口说明
有接II响应的返回信息均以JSON字符串形式返回,可以使用JSON工具包对其进行解析。
回信息具体字段参照接II说明中的响应参数,以卞以举例:
处理成功:
{"resultcode":
O,"resultDesc":
"处理成功"}
处理失败:
{“「esultCodmesultDesc”:
”签名错误,'}
回结果码对照见附录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路径.“信息平台”会自动抓取
leaderldcard
M
VL150
工人身份证号
检査工人是否存在的依据.使JUDES加密
leaderName
M
VL30
工人姓名
leaderSex
M
FL1
卜别
M:
男F:
女
leaderNation
M
VL40
民族
leaderBirthday
M
FL8
生日
yyyyMMdd
leaderAddress
M
VL400
住址
身份证上的住址
leaderSignOrgan
M
VL30
签发机关
身份证的签发机关
leaderExpiryStart
M
FL8
有效期开始日期
身份证有效期开始日期
leaderExpiryEnd
O
FL8
有效期结束日期
身份证有效期结束日期.为空表示长期
leaderHeadlmg
O
VL400
身份证头像URL
外网能访问的URL路径.“信息平台”会自动抓取
leaderldcardFront
O
VL150
0
身份证正面照
外网能访问的URL路径,“信息平台炉会自动抓取,使用DES加密
leaderldcardBack
o
VL150
0
身份证反面照
外网能访问的URL路径,“信息平台”会自动抓取,使用DES加密
leaderCurrentAddress
M
VL400
常住地址
近期的常住地址
leaderPolitical
M
FL1
政治而貌
0:
党员1:
团员2:
群众
leaderEducation
M
VL32
文化程度
本科以上、本科、大专.中专、高中、初中及以下
leaderPhone
M
VL11
手机号
leaderEmploylype
M
FL1
用工形式
0:
固定工人1:
外聘
leaderTechLevel
M
FL1
技能水平
0:
无(普通):
1:
初级工:
2:
中级工:
3:
鬲级工:
4:
技师:
5:
高级技师
leaderContractCode
O
VL50
合同编号
施工企业内部的合同编号。
leaderContractFile
O
VL400
合同附件
外网能访问的URL路径•"信息平台”会自动抓取。
leaderCardNum
O
VL150
工资卡账号
使用DES加密
leaderCardBank
o
VL10
工资卡开户行代
码
参考附录4.4
leaderWorkType
M
VL32
工种代码
参考附录4.3
leaderSecurityCode
O
VL300
社保号
使用DES加密
leaderSafetyEdu
M
FL1
是否参加安全教
育
true:
是:
false:
否
leaderSafetyEduImg
O
VL400
安全教育图片
外网能访问的URL路径「'信息平台”会自动抓取。
leaderBuilderlype
M
FL1
工人类型
0:
建筑工匠:
1:
建筑产业技术工人:
2:
其他
leaderDoDate
M
FL8
进场日期
yyyyMMdd
timestamp
M
FL17
时间戳
北京时间粘确到它秒(yyyyMMddHHmmssSSS)
sign
M
FL32
签名
响应参数
参效
限制
说明
resultcode
M
返回结果码,数字类型。
0表示成功:
其它表示失败。
resultDesc
O
返回结果描述
3.2修改班组
接口说明
接口描述
施工企业修改班组时调用
请求地址
/smz/team/update
测试请求地址
请求参数
参数
限制
注料
备注
accessNo
M
FL32
接入编号
“信息平台”为施工企业分配的接入编号
工程内部的班组唯一编码,如果班组编码已存在則
teamCode
M
VL320
班组编码
修改班组.格式:
班组长身份证号+班组类型代
码,使用DES加密
name
M
VL40
班组名称
班组命名格式:
班组氏姓名+班组类型+“班组”
workType
M
VL32
班组类型
参考附录4.3
leaderAppointment
O
VL400
班组长证明书
外网能访问的URL路径,“信息平台”会自动抓取
leaderldcard
M
VL150
工人身份证号
检査工人是否存在的依据,使用DES加密
leaderCurrentAddress
M
VL400
常住地址
近期的常住地址
leaderPolitical
M
FL1
政治而貌
0:
党员1:
团员2:
群众
leaderEducation
M
VL32
文化程度
本科以上、本科、大专.中专、高中、初中及以下
leaderPhone
M
VL11
手机号
leaderEmploylype
M
FL1
用工形式
0:
固定工人1:
外聘
leaderTechLevel
M
FL1
技能水平
0:
无(普通):
1:
初级工:
2:
中级工:
3:
鬲级工;
4:
技师:
5:
高级技师
leaderContractCode
O
VL50
合同编号
施工企业内部的合同编号。
leaderContractFile
O
VL400
合同附件
外网能访问的URL路径,"信息平台”会自动抓取。
leaderCardNum
o
VL150
工资卡账号
使用DES加密
leaderCardBank
o
VL10
工资卡开户行代
码
参考附录4.4
leaderWorkType
M
VL32
工种代码
参考附录4.3
leaderSecurityCode
O
VL300
社保号
使用DES加密
leaderSafetyEdu
M
FL1
是否参加安全教
育
true:
是:
false:
否
leaderSafetyEduImg
O
VL400
安全教育图片
外网能访问的URL路径•“信息平台”会自动抓取。
leaderBuilderType
M
FL1
工人类型
0:
建筑工匠:
1:
建筑产业技术工人:
2:
其他
timestamp
M
FL17
时间戳
北京时间粘确到它抄(yyyyMMddHHmmssSSS)
sign
M
FL32
签名
响应参数
限制
说明
resultcode
M
返回结果码,数字类型。
0表示成功:
其它表示失败。
resultDesc
O
返回结果描述
3.3添加班组工人
接口说明
接口描述
为已登记的班组添加工人。
请求地址
/smz/teamBuilder/save
测试请求地址
请求参数
限制
注释
备注
accessNo
M
FL32
\編号
“信息平台”为施工企业分配的接入编号
teamCode
M
VL320
班组編码
工程内部的班组唯一编码,如果班组编码己存在則修改班组,使用DES加密
idcard
M
VL150
工人身份证号
检査工人是否存在的依据,如果工人已存在则修改.使用DES加密
name
M
VL30
匸人姓名
sex
M
FL1
匸別
M:
男F:
女
nation
M
VL40
民族
birthday
M
FL8
生日
yyyyMMdd
address
M
VL400
住址
身份证上的住址
signOrgan
M
VL30
签发机关
身份证的签发机关
expiryStart
M
FL8
有效期开始日期
身份证有效期开始日期
expiryEnd
O
FL8
有效期结束日期
身份证有效期结束日期.为空表示长期
headlmg
O
VL400
身份证头像URL
外网能访问的URL路径.“信息平台”会自动抓取
idcardFront
O
VL1500
身份证正面照
外网能访问的URL路径.“信息平台”会自动抓取,使用DES加密
idcardBack
O
VL1500
身份证反面照
外网能访问的URL路径,“信息平台”会自动抓取,使用DES加密
currentAddress
M
VL400
常住地址
近期的常住地址
political
M
FL1
政治面綿
0:
党员1:
团员2:
群众
education
M
VL20
文化程度
本科以上、本科.大专.中专、高中、初中及以下
phone
M
VL11
『机号
employlype
M
FL1
用工类型
0:
自有工人:
1:
外聘工人
contractcode
O
VL50
合同编号
施工企业内部的合同编号。
contractFile
O
VL400
合同附件
外网能访问的URL路径「'信息平台”会自动抓取。
cardNum
O
VL150
工资卡账号
使用DES加密
cardBank
o
VL10
工资卡开户行代码
参考附录4.4
workType
M
VL32
工种代码
参考附录4.3
techLevel
M
FL1
技能水平
0:
无(普通):
1:
初级工:
2:
中级工:
3:
鬲级工;
4:
技师:
5:
高级技师
securityCode
O
VL300
社保号
使用DES加密
safetyEdu
M
FL1
是否参加安全教育
true:
是:
false:
否
safetyEduImg
O
VL400
安全教育图片
外网能访问的URL路径「'信息平台”会自动抓取。
builderType
M
FL1
工人类型
0:
建筑工匠:
1:
建筑产业技术工人:
2:
其他
doDate
M
FL8
进场日期
yyyyMMdd
timestamp
M
FL17
时间戳
北京时间枯确到它抄(yyyyMMddHHmmssSSS)
sign
M
FL32
签名
响应参数
参数
限制
说明
resultcode
M
返回结果码,数字类型。
0表示成功:
其它表示失败。
resultDesc
O
返回结果描述
3.4修改班组工人
接口说明
接口描述
修改已登记的班组工人。
请求地址
/smz/teamBuilder/update
测试请求地址
请求参数
参数
限制
注释
备注
accessNo
M
FL32
\編号
“信息平台”为施工企业分配的接入编号
teamCode
M
VL320
班组编码
工程内部的班组唯一编码,如果班组編码已存在则修改班组,使用DES加密
idcard
M
VL150
工人身份证号
检査工人是否存在的依据,如果工人已存在则修改.使用DES加密
currentAddress
M
VL400
常住地址
近期的常住地址
political
M
FL1
政治面綿
0:
党员1:
团员2:
群众
education
M
VL20
文化程度
本科以上、本科、大专.中专、高中、初中及以下
phone
M
VL11
『机号
employlype
M
FL1
用工类型
0:
自有工人:
1:
外聘工人
contractcode
O
VL50
合同编号
施工企业内部的合同编号。
contractFile
O
VL400
合同附件
外网能访问的URL路径「'信息平台”会自动抓取。
cardNum
O
VL150
工资卡账号
使用DES加密
cardBank
o
VL10
工资卡开户行代码
参考附录4.4
workType
M
VL32
工种代码
参考附录4.3
techLevel
M
FL1
技能水平
0:
无(普通):
1:
初级工:
2:
中级工:
3:
高级工;
4:
技师:
5:
高级技师
securityCode
O
VL300
社保号
使用DES加密
safetyEdu
M
FL1
是否参加安全教育
true:
是:
false:
否
safetyEduImg
O
VL400
安全教育图片
外网能访问的URL路径「'信息平台”会自动抓取。
builderType
M
FL1
工人类型
0:
建筑工匠:
1:
建筑产业技术工人:
2:
其他
timestamp
M
FL17
时间戳
北京时间粘确到它秒(yyyyMMddHHmmssSSS)
sign
M
FL32
签名
响应参数
参效
限制
说明
resultcode
M
返回结果码,数字类型。
0表示成功:
其它表示失败。
resultDesc
O
返回结果描述
3.5班组工人进退场
接口说明
接口描述
班组工人进场或退场。
请求地址
/smz/enterExit/save
测试请求地址
请求参数
限制
Of
注释
备注
accessNo
M
FL32
後入编号
“信息平台”为施工企业项目分配的接入编号
teamCode
M
VL320
班组编码
工程内部的班组唯一編码,如果班组編码已存在则修改班组,使用DES加密
idcard
M
VL150
工人身份证号
检査工人是否存在的依据,使用des加密
type
M
FL1
芒型
0:
进场:
1:
退场
doDate
M
FL8
进退场日期
yyyyMMdd
timestamp
M
FL17
时间戳
北京时间椅确到临秒(yyyyMMddHHmmssSSS)
sign
M
FL32
签名
响应参数
参效
限制
说明
resultcode
M
返回结果码,数字类型。
0表示成功:
其它表示失败。
resultDesc
O
返回结果描述
四.附录
4.1测试环境
测试坏境接入编号:
测试坏境接入密钥:
4.2结果码对照表
返回码
返回码文本介绍
说明
0
请求成功
当且仅当返回码为0时.请求成功
1
签名验证失败
签名错误
2
参数错误
参数长度或数据类型错误
3
接入编号错误
接入编号不存在
201
班组不存在
添加修改班组工人时返回
202
工人不存在
添加修改工人证书、添加修改班组工人时返回
■1
系统内部异常:
[・・],请稍候再试
系统内部异常,返回异常描述
4.3工种代码表
工种代码・xlsx
4.4银行代码表
银行代码・xlsx
4.5调用示例
1、将参数排序(以JavaTreeMap实现参数名按ASCII字典顺序排序)TreeMap
params.putf^paramr7,urlencode("valueT:
"UTF・8"));params.put(/zparam2///urlencode(//value2/f/"UTF・8"));
2、将参数拼接成字符串(空值不参与签名)
Stringstr=IH,;
for(param:
params){
if(param.value!
=null&¶m.value」ength()>0){
str+=+param.key+"="+param.value;
}
}
str=str.substring(l,str.length());
3、生成签名
Stringsign=md5(str+key);params.put(,lsignl,/sign);
4、提交数据
http.post(params);
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 广州市 建设 领域 管理 应用 信息 平台