《广州建设领域管理应用信息平台》由会员分享，可在线阅读，更多相关《广州建设领域管理应用信息平台（14页珍藏版）》请在金锄头文库上搜索。
1、 广州市建设领域管理应用信息平台建筑工人实名制数据接口标准目录一、引言11.1编写目的11.2适用范围11.3简称和术语1二、开发规范22.1通信协议22.2通信安全22.3注意事项2三、接口说明43.1新增班组43.2修改班组53.3添加班组工人63.4修改班组工人83.5班组工人进退场9四、附录104.1 测试环境104.2 结果码对照表104.3 工种代码表104.4 银行代码表11 / 文档可自由编辑打印一、引言1.1编写目的为实现广州市建设领域管理应用信息平台对项目从业人员实名制管理，考虑到部分项目已经在使用一些商业化实名制管理系统，为避免数据重复登记、减少系统改造成本，特编写本接口
2、文档以供施工企业相关技术人员对接。1.2适用范围本文档的适用对象为接入广州市建设领域管理应用信息平台的施工企业技术开发人员、日常维护人员。1.3简称和术语广州市建设领域管理应用信息平台：以下简称“信息平台”施工企业：指依法取得施工企业资质证书，在本市从事建设施工活动的施工总承包企业、专业承包企业和劳务分包企业二、开发规范2.1通信协议l 采用HTTP（或HTTPS）协议进行请求和响应的处理。接口请求采用GET/POST方式。接口响应返回JSON格式的数据。l 由“信息平台”提供接口地址，企业实名制或考勤系统。l 接口请求URL地址：详见接口说明。l 接口未注明处均使用UTF-8编码。l 通信过
3、程中涉及的中文或特殊符号的传输，需进行urlencode处理。l HTTP（或HTTPS）请求参数均为字符串。l 接口请求需进行签名，详见2.2通信安全一节。2.2通信安全为保证数据传输过程中的数据真实性，我们需要对数据进行数字签名，在接收签名数据之后进行签名校验。“信息平台”会为施工企业的每个工程分配唯一的接入编号和接入密钥。签名机制如下：l 对全部有长度限制的传输字段（不包括NL类型的字段）进行签名，将参数名（区分大小写）和参数值（需进行urlencode处理）用“=”连接，参数值为空的参数不参与签名，参数之间用“&”连接，格式是：param1=val1¶m2=val2。l 参数组
4、装顺序规则：参数名的字典顺序。l 密钥拼接方式为传输参数直接连接密钥，如只有param1和param2两参数，值分别为val1和val2，密钥为key，拼接结果为：param1=val1¶m2=val2key。l 使用“信息平台”分配的密钥进行MD5加密（密钥直接跟在组装好的参数后即可），将值赋给sign参数。l 敏感信息班组编号、身份证图片路径、身份证号、银行卡号、社保号需要加密传输，使用DES加密，加密key等于接入密钥，加密后的字节码转为16进制编码的字符串，并在密文字符串的前面加“des:”前缀。算法：密文=”des:” + HEX(DES(idcard, key)，如：身份证
5、号：，接入密钥：8c2da4c769828fcfa77aedb690999cf9，密文：des:80cfe03525bb2b8d43d62ff369e95334cd1facfe4bbb800c2.3注意事项l 接口中各项参数当标识是M时参数必选，为O时可选。l 接口字段长度分为三种：无限制（NL），固定长度（FL），可变长度（VL）。如果为FL，则长度必须精确到FL后跟随的数字，格式举例FL14；如果为VL，则长度在可变范围内即可，如果长度不够，不补空格或其它字符，格式举例VL30。l 接口说明中，若参数字体为红色，请仔细阅读备注说明。l 请求返回结果码不为0时，需要再次提交请求。如果结果码大
6、于0，则需要根据提示信息修改错误后再次提交；如果结果码小于0，可以间隔一段时间再提交（如：选择间隔5分钟、10分钟、30分钟、1小时提交一次，连续5次提交不成功时推迟到第二天再提交）。三、接口说明l 所有接口响应的返回信息均以JSON字符串形式返回，可以使用JSON工具包对其进行解析。l 返回信息具体字段参照接口说明中的响应参数，以下以举例：处理成功：resultCode:0,resultDesc:处理成功处理失败：resultCode:1,resultDesc:签名错误l 返回结果码对照见附录4.2结果码对照表。3.1新增班组接口说明接口描述施工企业添加班组时调用请求地址/smz/team/
7、save测试请求地址请求参数参数限制长度注释备注accessNoMFL32接入编号“信息平台”为施工企业分配的接入编号teamCodeMVL320班组编码工程内部的班组唯一编码，如果班组编码已存在则修改班组。格式：班组长身份证号 + 班组类型代码，使用DES加密nameMVL40班组名称班组命名格式：班组长姓名 + 班组类型 + “班组”workTypeMVL32班组类型参考附录4.3leaderAppointmentOVL400班组长证明书外网能访问的URL路径，“信息平台”会自动抓取leaderIdcardMVL150工人身份证号检查工人是否存在的依据，使用DES加密leaderNameM
8、VL30工人姓名leaderSexMFL1性别M：男 F：女leaderNationMVL40民族leaderBirthdayMFL8生日yyyyMMddleaderAddressMVL400住址身份证上的住址leaderSignOrganMVL30签发机关身份证的签发机关leaderExpiryStartMFL8有效期开始日期身份证有效期开始日期leaderExpiryEndOFL8有效期结束日期身份证有效期结束日期，为空表示长期leaderHeadImgOVL400身份证头像URL外网能访问的URL路径，“信息平台”会自动抓取leaderIdcardFrontOVL1500身份证正面照外网
9、能访问的URL路径，“信息平台”会自动抓取，使用DES加密leaderIdcardBackOVL1500身份证反面照外网能访问的URL路径，“信息平台”会自动抓取，使用DES加密leaderCurrentAddressMVL400常住地址近期的常住地址leaderPoliticalMFL1政治面貌0：党员 1：团员 2：群众leaderEducationMVL32文化程度本科以上、本科、大专、中专、高中、初中及以下leaderPhoneMVL11手机号leaderEmployTypeMFL1用工形式0：固定工人 1：外聘leaderTechLevelMFL1技能水平0：无(普通)；1：初级工；
10、2：中级工；3：高级工；4：技师；5：高级技师leaderContractCodeOVL50合同编号施工企业内部的合同编号。leaderContractFileOVL400合同附件外网能访问的URL路径，“信息平台”会自动抓取。leaderCardNumOVL150工资卡账号使用DES加密leaderCardBankOVL10工资卡开户行代码参考附录4.4leaderWorkTypeMVL32工种代码参考附录4.3leaderSecurityCodeOVL300社保号使用DES加密leaderSafetyEduMFL1是否参加安全教育true: 是；false：否leaderSafetyEdu
11、ImgOVL400安全教育图片外网能访问的URL路径，“信息平台”会自动抓取。leaderBuilderTypeMFL1工人类型0：建筑工匠；1：建筑产业技术工人；2：其他leaderDoDateMFL8进场日期yyyyMMddtimestampMFL17时间戳北京时间精确到毫秒(yyyyMMddHHmmssSSS)signMFL32签名响应参数参数限制说明resultCodeM返回结果码，数字类型。0表示成功；其它表示失败。resultDescO返回结果描述3.2修改班组接口说明接口描述施工企业修改班组时调用请求地址/smz/team/update测试请求地址请求参数参数限制长度注释备注ac
12、cessNoMFL32接入编号“信息平台”为施工企业分配的接入编号teamCodeMVL320班组编码工程内部的班组唯一编码，如果班组编码已存在则修改班组。格式：班组长身份证号 + 班组类型代码，使用DES加密nameMVL40班组名称班组命名格式：班组长姓名 + 班组类型 + “班组”workTypeMVL32班组类型参考附录4.3leaderAppointmentOVL400班组长证明书外网能访问的URL路径，“信息平台”会自动抓取leaderIdcardMVL150工人身份证号检查工人是否存在的依据，使用DES加密leaderCurrentAddressMVL400常住地址近期的常住地址
13、leaderPoliticalMFL1政治面貌0：党员 1：团员 2：群众leaderEducationMVL32文化程度本科以上、本科、大专、中专、高中、初中及以下leaderPhoneMVL11手机号leaderEmployTypeMFL1用工形式0：固定工人 1：外聘leaderTechLevelMFL1技能水平0：无(普通)；1：初级工；2：中级工；3：高级工；4：技师；5：高级技师leaderContractCodeOVL50合同编号施工企业内部的合同编号。leaderContractFileOVL400合同附件外网能访问的URL路径，“信息平台”会自动抓取。leaderCardNumOVL150工资卡账号使用DES加密leaderCardBankOVL10工资卡开户行代码参考附录4.4leaderWorkTypeMVL32工种代码参考附录4.3leaderSecurityCodeOVL300社保号使用DES加密leaderSafetyEduMFL1是否参加安全教育true: 是；false：否leaderSafetyEduImgOVL400安全教育图片外网能访问的URL路径，“信息平台”会自动抓取。leaderBuilderTypeMFL1工人类型0：建筑工匠；1：建筑产业技术工人；2：其他times
