广州市建设领域管理应用信息平台文档格式.docx
《广州市建设领域管理应用信息平台文档格式.docx》由会员分享，可在线阅读，更多相关《广州市建设领域管理应用信息平台文档格式.docx（19页珍藏版）》请在冰豆网上搜索。
●参数组装顺序规则：
参数名的字典顺序。
●密钥拼接方式为传输参数直接连接密钥，如只有param1和param2两参数，值分别为val1和val2，密钥为key，拼接结果为：
param2=val2key。
●使用“信息平台”分配的密钥进行MD5加密（密钥直接跟在组装好的参数后即可），将值赋给sign参数。
●敏感信息班组编号、身份证图片路径、身份证号、银行卡号、社保号需要加密传输，使用DES加密，加密key等于接入密钥，加密后的字节码转为16进制编码的字符串，并在密文字符串的前面加“des:
”前缀。
算法：
密文=”des:
”+HEX（DES（idcard,key）），如：
身份证号：
511301************1，接入密钥：
8c2da4c769828fcfa77aedb690999cf9，密文：
des:
80cfe03525bb2b8d43d62ff369e95334cd1facfe4bbb800c
2.3注意事项
●接口中各项参数当标识是M时参数必选，为O时可选。
●接口字段长度分为三种：
无限制（NL），固定长度（FL），可变长度（VL）。
如果为FL，则长度必须精确到FL后跟随的数字，格式举例FL14；
如果为VL，则长度在可变范围内即可，如果长度不够，不补空格或其它字符，格式举例VL30。
●接口说明中，若参数字体为红色，请仔细阅读备注说明。
●请求返回结果码不为0时，需要再次提交请求。
如果结果码大于0，则需要根据提示信息修改错误后再次提交；
如果结果码小于0，可以间隔一段时间再提交（如：
选择间隔5分钟、10分钟、30分钟、1小时提交一次，连续5次提交不成功时推迟到第二天再提交）。
三、接口说明
●所有接口响应的返回信息均以JSON字符串形式返回，可以使用JSON工具包对其进行解析。
●返回信息具体字段参照接口说明中的响应参数，以下以举例：
处理成功：
{"
resultCode"
:
0,"
resultDesc"
"
处理成功"
}
处理失败：
1,"
签名错误"
●返回结果码对照见附录4.2结果码对照表。
3.1新增班组
接口说明
接口描述
施工企业添加班组时调用
请求地址
/smz/team/save
测试请求地址
请求参数
参数
限制
长度
注释
备注
accessNo
M
FL32
接入编号
“信息平台”为施工企业分配的接入编号
teamCode
VL320
班组编码
工程内部的班组唯一编码，如果班组编码已存在则修改班组。
格式：
班组长身份证号+班组类型代码，使用DES加密
name
VL40
班组名称
班组命名格式：
班组长姓名+班组类型+“班组”
workType
VL32
班组类型
参考附录4.3
leaderAppointment
O
VL400
班组长证明书
外网能访问的URL路径，“信息平台”会自动抓取
leaderIdcard
VL150
工人身份证号
检查工人是否存在的依据，使用DES加密
leaderName
VL30
工人姓名
leaderSex
FL1
性别
M：
男F：
女
leaderNation
民族
leaderBirthday
FL8
生日
yyyyMMdd
leaderAddress
住址
身份证上的住址
leaderSignOrgan
签发机关
身份证的签发机关
leaderExpiryStart
有效期开始日期
身份证有效期开始日期
leaderExpiryEnd
有效期结束日期
身份证有效期结束日期，为空表示长期
leaderHeadImg
身份证头像URL
leaderIdcardFront
VL1500
身份证正面照
外网能访问的URL路径，“信息平台”会自动抓取，使用DES加密
leaderIdcardBack
身份证反面照
leaderCurrentAddress
常住地址
近期的常住地址
leaderPolitical
政治面貌
0：
党员1：
团员2：
群众
leaderEducation
文化程度
本科以上、本科、大专、中专、高中、初中及以下
leaderPhone
VL11
手机号
leaderEmployType
用工形式
固定工人1：
外聘
leaderTechLevel
技能水平
无（普通）；
1：
初级工；
2：
中级工；
3：
高级工；
4：
技师；
5：
高级技师
leaderContractCode
VL50
合同编号
施工企业内部的合同编号。
leaderContractFile
合同附件
外网能访问的URL路径，“信息平台”会自动抓取。
leaderCardNum
工资卡账号
使用DES加密
leaderCardBank
VL10
工资卡开户行代码
参考附录4.4
leaderWorkType
工种代码
leaderSecurityCode
VL300
社保号
leaderSafetyEdu
是否参加安全教育
true:
是；
false：
否
leaderSafetyEduImg
安全教育图片
leaderBuilderType
工人类型
建筑工匠；
建筑产业技术工人；
其他
leaderDoDate
进场日期
timestamp
FL17
时间戳
北京时间精确到毫秒（yyyyMMddHHmmssSSS）
sign
签名
响应参数
说明
resultCode
返回结果码，数字类型。
0表示成功；
其它表示失败。
resultDesc
返回结果描述
3.2修改班组
施工企业修改班组时调用
/smz/team/update
3.3添加班组工人
为已登记的班组添加工人。
/smz/teamBuilder/save
工程内部的班组唯一编码，如果班组编码已存在则修改班组，使用DES加密
idcard
检查工人是否存在的依据，如果工人已存在则修改，使用DES加密
sex
nation
birthday
address
signOrgan
expiryStart
expiryEnd
headImg
idcardFront
idcardBack
currentAddress
political
education
VL20
phone
employType
用工类型
自有工人；
外聘工人
contractCode
contractFile
cardNum
cardBank
techLevel
securityCode
safetyEdu
safetyEduImg
builderType
doDate
3.4修改班组工人
修改已登记的班组工人。
/smz/teamBuilder/update
签名
3.5班组工人进退场
班组工人进场或退场。
/smz/enterExit/save
“信息平台”为施工企业项目分配的接入编号
type
类型
进场；
退场
进退场日期
四、附录
4.1测试环境
测试环境接入编号：
测试环境接入密钥：
4.2结果码对照表
返回码
返回码文本介绍
请求成功
当且仅当返回码为0时，请求成功
1
签名验证失败
签名错误
2
参数错误
参数长度或数据类型错误
3
接入编号错误
接入编号不存在
201
班组不存在
添加修改班组工人时返回
202
工人不存在
添加修改工人证书、添加修改班组工人时返回
-1
系统内部异常:
[..],请稍候再试
系统内部异常，返回异常描述
4.3工种代码表
4.4银行代码表
4.5调用示例
1、将参数排序（以JavaTreeMap实现参数名按ASCII字典顺序排序）
TreeMap<
String,String>
params=newTreeMap<
>
（）;
params.put（“param1”,urlencode（“value1”,“UTF-8”））;
params.put（“param2”,urlencode（“value2”,“UTF-8”））;
2、将参数拼接成字符串（空值不参与签名）
Stringstr="
;
for（param:
params）{
if（param.value!
=null&
&
param.value.length（）>
0）{
str+="
+param.key+"
="
+param.value;
}
str=str.substring（1,str.length（））;
3、生成签名
Stringsign=md5（str+key）;
params.put（"
sign"
sign）;
4、提交数据
http.post（params）;
升级会员 