广州建设领域管理应用信息平台

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简称和术语广州市建设领域管理应用信息平台：以下简称“信息平台”施工企业：指依法取得施工企业资质证书，在本市从事建设施工活动的施工总承包企业、专 业承包企业和劳务分包企业11二、开发规范2.1通信协议 采用HTTP （或HTTPS）协议进行请求和响应的处理。接口请求采用GET/POST方式。 接口响应返回JSON格式的数据。 由“信息平台”提供接口地址，企业实统制或考勤系统。 接口请求URL地址：详见接口说明。 接口未注明处均使用UTF-8编码。 通信过程中涉及的中文或特殊符号

3、的传输，需进行urlencode处理。 HTTP （或HTTPS）请求参数均为字符串。 接口谙求需进行签名，详见2. 2通信安全一节。2. 2通信安全为保证数据传输过程中的数据貞实性，我们需要对数据进行数字签名，在接收签名数据 之后进行签名校验。“信息平台”会为施工企业的每个工程分配唯一的接入编号和接入密钥。签斜机制如下: 对全部有长度限制的传输字段（不包括NL类型的字段）进行签名，将参数名（区 分大小写）和参数值（需进行urlencod亡处理）用连接，参数值为空的参数 不参9签名，参数之间用&连接，格式是：paraml=vall¶m2=xal2.o 参数组装顺序规则：参数名的字典顺序

4、。 密钥拼接方式为传输参数直接连接密钥，如只有param 1和param2两参数，值分 别为 vail 和 val2,密钥为 key,拼接结果为：paraml=vall¶m2=val2keyo 使用信息平台”分配的密钥进行MD5加密（密钥直接跟在组装好的参数后即可）， 将值赋给sign参数。 敏感信息班组编号、身份证图片路径、身份证号、银行卡号、fid 要加密传输, 使用DES加密，加密key等于接入密钥，加密后的字节码转为16进制编码的字符 串，并在密文字符串的前而加“des:”前缀。算法：密文=des: + HEX（DES（idcard, key）, 如：身份证号：51130119

5、90010181111,接入密钥： 8c2da4c769828fcfa77aedb690999cf9,密文： des:80cfe03525bb2b8d43d62ff369e95334cdlfacfe4bbb800c112. 3注意事项 接口中各项参数当标识是M时参数必选，为0时可选。 接口字段长度分为三种：无限制（NL）,固泄长度（FL）,可变长度（VL）。如果 为FL,则长度必须精确到FL后跟随的数字，格式举例FL14：如果为VL,则长度在 可变范围内即可，如果长度不够，不补空格或页它字符，格式举例VL30. 接口说明中，若参数字体为红色，请仔细阅读备注说明。 请求返回结果码不为0时，需要再

6、次提交请求。如果结果码大于0,则需要根据提 示信息修改错误后再次提交；如果结果码小于0,可以间隔一段时间再提交（如： 选择间隔5分钟、10分钟、30分钟、2小时提交一次，连续5次提交不成功时推 迟到第二天再提交）。11三、接口说明 所有接口响应的返回信息均以JSON字符串形式返回，可以使用JSONI具包对 英进行解析。 返回信息具体字段参照接口说明中的响应参数，以下以举例：处理成功：resultCodeO/resultDesc:处理成功处理失败：lesultCodmesultDesc 签名错误 返回结果码对照见附录4.2结果码对照表。3.1新增班组接口说明接口描述施工企业添加班组时调用请求地址

7、/smz/team/save测试请求地址请求参数参敷RM长度注秤备注accessNoMFL32接入编号“倍息平台”为施I：企业分配的接入编兮工程内部的班组唯一编码.如果班组编码已存在则teamCodeMVL320班蛆編码修改班组.洛式：班组长身份证号+班俎类型代码，使用DES加密n ameMVL40班组名称班组命名格式：班组长姓名+班组类型+ “班 组”worklypeMVL32班组类型参考附录43leaderApp oin tment0VL400班组长证明书外网能访问的URL路径“信息平台”会自动抓取leaderldcardMVL150匸人身份证号检査工人是否存在的依据.便-IDES L *

8、leaderNameMVL30工人姓名leaderSexMFL1性别M：男F：女leaderNati onMVL40民族leaderBirthdayMFL8牛 1丨yyyyMMdd11leaderAddressMVL400住址身份证上的住址leaderSig nOrga nMVL30签发机关身份证的签发机关leaderExpiryStartMFL8有效期开始日期身份证有效期开始日期leaderExpiryE nd0FL8有效期结束11期身份证有效期结束口期.为空表示长期leaderHeadlmg0VL400身份证头橡URL外网能访问的URL路径“倍息平台”会自动抓取leaderldcardFr

9、ontOVL1500身份证正面照外网能访问的URL路径，“信息平台”会自动抓 取，使用DES加密leaderldcardBackoVL1500身份证反面照外网能访问的URL路径，“信息平台力会自动抓 取.使用DES加密leaderCurre ntAddressMVL400常住地址近期的常住地址leaderPoliticalMFL1政治面貌0：党员1：团员2：群众leaderEducati onMVL32文化程度本科以上.本科.大专.中专.高屮.初屮及以下leaderPh oneMVL11F机号leaderEmploylypeMFL1用工形式0：固定匸人1：外聘leaderlechLevelMF

10、L1技能水平0：无（普通）：1：初级I：； 2：屮级1： 3：高级1：4：技师：5：高级技师leaderC on tractcode0VL50介同编号施工企业内部的合冋編号。leaderC on tractFile0VL400合冋附件外网能访问的URL路径“倍息平台”会门动抓取。leaderCardNumOVL150工资卡底号使用DES加密leaderCardBa nk0VL10匸资卡开户行代 码参考附录44leaderWorklypeMVL32工种代码参考附录4.3leaderSecurityCodeOVL300杜保号使用DES加密leaderSafetyEduMFL1是否参加安全教true

11、:是：false：否leaderSafetyEduImg0VL400安全教育图片外网能访问的URL路径“信息平台”会自动抓取。leaderBuilderlypeMFL1I：人类型0：建筑EE： 1：建荻产业技术工人：2：其他leaderDoDateMFL8进场口期yyyyMMddtimestampMFL17时间截北京时间将确到(yyyyMMddHHmmssSSS)signMFL32签名响应参数参数限制说明11resultcodeM返回结果码数字类型。0表示成功：其它表示失败。resultDesc0返回结果描述3.2修改班组接口说明接口描述施丄企业修改班组时调用请求地址/smz/team/upd

12、ate测试请求地址请求参数限制长度注释备注accessNoMFL32接入编号“信息平台”为施匸企业分配的接入编号工程内部的班组唯一编码，如果班组编网已存在则teamCodeMVL320班组编码修改班组.格式：班组长身份证号+班组类型代码，使用DES加密n ameMVL40班组名称班组命名格式,/-名+班组类型+组”worklypeMVL32班组类型参考附录43leaderAppointme nt0VL400班组长证明书外网能访问的URL路径，“倍息平台”会自动抓取leaderldcardMVL150工人身份证号检査工人是否存在的依据，使用DES加密leaderCurre ntAddressMV

13、L400常住地址近期的常住地址leaderPoliticalMFL1政治面貌0：党员1：团员2：群众leaderEducati onMVL32文化程度本科以上.本科.大专.屮专.高屮.初屮及以下leaderPh oneMVL11乎机号leaderEmploylypeMFL1用匸形式0：固定工人1：外聘leaderlechLevelMFL1技陆水平0：无（普通）:1：初级1： 2：中级E： 3：高级E：4：技师；5：高级技师leaderC on tractcode0VL50介同编施工企业内部的合同編号。leaderC on tractFile0VL400介同附件外网能访问的URL路径“倍息平台”

14、会自动抓取。leaderCardNumOVL150工资卡帐号使用DES加密leaderCardBa nk0VL10匸资卡开户行代 码参考附录4.4leaderWorklypeMVL32工种代码参考附录4311leaderSecurityCodeOVL300社保号使用DES加密leaderSafetyEduMFL1是否参加安全教育true:是：false：否leaderSafetyEduImg0VL400安全教育图片外网能访何的URL路径“倍息平台”会自动抓取。leaderBuilderTypeMFL1匸人类型0：建筑匸匠：1：建筑产业技术工人：2：其他timestampMFL17时间戳北京时间

15、将确到临秒(yyyyMMddHHmmssSSS)signMFL32签名响应参数参数resultcode限制M返回结果码.数字类型。说明0表示成功：其它表示失败。resultDesc0返回结果描述3.3添加班组工人接口说明接口描述为已登记的班组添加工人C请求地址/smz/teamBuilder/save测试请求地址请求参数鲁数限制长度ft#备注accessNoMFL32接入编号“信息平台”为施匸企业分配的接入編兮teamCodeMVL320班组編码工程内部的班组唯一编码，如果班组编码已存在则 修改班组.使用DES加密idcardMVL150工人身份证号检査工人是否存在的依拡.如果工人已存在则修

16、改，使用DES加密n ameMVL30I：人姓名sexMFL1件别M：男F：女nationMVL40民族birthdayMFL8生日yyyyMMddaddressMVL400住址身份证上的住址sign Orga nMVL30签发机关身份证的签发机关11expiryStartMFL8有效期开始口期身份证冇效期开始11期expiryE nd0FL8有效期结束口期身份证有效期结柬口期.为空表示长期headlmg0VL400身份证头像URL外网能访何的URL路径.“信息平台”会自动抓取idcardFrontOVL1500身份证正面照外网能访问的URL路径，“信息平台”会自动抓 取，使用DES加密idc

17、ardBackOVL1500身份证反面照外网能访问的URL路径.“信息平台”会自动抓 恥使用DES加巒curre ntAddressMVL400常住地址近期的常住地址politicalMFL1政治面貌0：党员1：团员2：群众educationMVL20文化程度本科以上.本科.大专.中专.髙中.初中及以下phoneMVL11手机号employTypeMFL1用工类型0：自有工人：1：外聘工人contractcode0VL50合同编号施工企业内部的合同編号。contractFile0VL400合冋附件外网能访问的URL路径“信息平台”会口动抓取。cardNumOVL150工资卡账号使用DES加密c

18、ard Ba nk0VL10L资卡开户行代码参考附录4.4worklypeMVL32匸种代码参考附录43techLevelMFL1技能水平0：无（普通）:1：初级1： 2：中级1： 3：高级E：4：技师；5：高级技师securityCodeOVL300社保号使用DES加密safety EduMFL1是否参加安全教育true:是：false：否safetyEduImg0VL400安全教育图片外网能访问的URL路径“信息平台”会口动抓取。builderlypeMFL1匸人类型0：建筑匸匠：1：建筑产业技术工人：2：其他doDateMFL8进场口期yyyyMMddtimestampMFL17时间戳北

19、京时间将确到(yyyyMMddHHmmssSSS)signMFL32签名响应参数限制说明resultcodeM返回结果码.数字类型。0表示成功：其它表示失败。resultDesc0返回结果描述113.4修改班组工人接口说明接口描述修改已登记的班组工人。请求地址/smz/teamBuilder/update测试请求地址请求参数参数限制ft#备注accessNoMFL32接入编号“信息平台”为施匸企业分配的接入編号teamCodeMVL320班组編码工程内部的班组唯一编码.如果班组编码已存在则 修改班组.使用DES加密idcardMVL150工人身份证号検査工人是否存在的依据.如果工人已存在则修

20、改，使用DES加密currentAddressMVL400常住地址近期的常住地址politicalMFL1政治面貌0：党员1：团员2：群众educati onMVL20文化程度本科以上.本科.大专.中专.高中.初中及以下phoneMVL11乎机号employTypeMFL1用工类型0：自有工人；1：外聘工人con tractcode0VL50合冋编号施工企业内部的合冋編号。contractFile0VL400合同附件外网能访问的URL路径“倍息平台”会门动抓取。cardNumOVL150工资卡账号使用DES加密card Ba nk0VL10匸资卡开户行代码参考附录4.4worklypeMVL3

21、2匸种代码参考附录43techLevelMFL1技能水平0：无(普通)：1：初级E： 2：屮级1： 3：高级1：4：技师：5：高级技师securityCodeOVL300社保号使用DES加密safety EduMFL1是否参加安全教育true:是：false：否safetyEduImg0VL400安全教育图片外网能访问的URL路径“倍息平台”会口动抓取。builderTypeMFL1工人类型0：述筑匸匠：1：建做产业技术工人：2：其他timestampMFL17时间戳北京时间将确到临抄(yyyyMMddHHmmssSSS)signMFL32响应参数11参数限制说明resultcodeM返回结果

22、码.数字类型。0表示成功：其它表示失败。resultDesc0返回结果描述3.5班组工人进退场接口说明接口描述班组工人进场或退场。请求地址/smz/e nterExit/save测试请求地址请求参数参数限制长度注释备注accessNoMFL32接入编号“倍息平台为施匸企业项口分配的接入编号teamCodeMVL320班组编码工程内部的班组唯一编码如果班组编码已存在则修 改班组，使用DES加密idcardMVL150工人身份证号检査工人是否存在的依据，使用DES加密typeMFL1类型0：进场：1：退场doDateMFL8进退场口期yyyyMMddtimestampMFL17时间戳北京时间楮确到宅抄(yyyyMMddH