广州建设领域管理应用信息平台Word格式文档下载.docx
《广州建设领域管理应用信息平台Word格式文档下载.docx》由会员分享，可在线阅读，更多相关《广州建设领域管理应用信息平台Word格式文档下载.docx（19页珍藏版）》请在冰豆网上搜索。
●接口未注明处均使用UTF-8编码。
●通信过程中涉及的中文或特殊符号的传输，需进行urlencode处理。
●HTTP（或HTTPS）请求参数均为字符串。
●接口请求需进行签名，详见2.2通信安全一节。
2.2通信安全
为保证数据传输过程中的数据真实性，我们需要对数据进行数字签名，在接收签名数据之后进行签名校验。
“信息平台”会为施工企业的每个工程分配唯一的接入编号和接入密钥。
签名机制如下：
●对全部有长度限制的传输字段（不包括NL类型的字段）进行签名，将参数名（区分大小写）和参数值（需进行urlencode处理）用“=”连接，参数值为空的参数不参与签名，参数之间用“&
”连接，格式是：
param1=val1&
param2=val2…。
●参数组装顺序规则：
参数名的字典顺序。
●密钥拼接方式为传输参数直接连接密钥，如只有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添加班组工人
接口说
升级会员 