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

1 1 2 2 广州市建设领域管理应用信息平台建筑工人实名制数据接口标准 目录 一、引言 1 编写目的 1 适用范围 1 简称和术语 1 二、开发规范 2 通信协议 2 通信安全 2 注意事项 3 三、接口说明 4 新增班组 4 修改班组 6 添加班组工人 7 修改班组工人 9 班组工人进退场 10 四、附录 10 测试环境 10 结果码对照表 11 工种代码表 11 银行代码表 11 1 1 2 2 一、引言 编写目的 为实现广州市建设领域管理应用信息平台对项目从业人员实名制管理，考虑到部分项目已经在使用一些商业化实名制管理系统，为避免数据重复登记、减少系统改造成本，特编写本接口文档以供施工企业相关技术人员对接。 适用范围 本文档的适用对象为接入广州市建设领域管理应用信息平台的施工企业技术开发人员、日常维护人员。 简称和术语 广州市建设领域管理应用信息平台：以下简称“信息平台” 施工企业：指依法取得施工企业资质证书，在本市从事建设施工活动的施工总承包企业、专业承包企业和劳务分包企业 二、开发规范 通信协议 采用 HTTP（或 HTTPS）协议进行请求和响应的处理。接口请求采用 GET/POST 方式。接口响应返回JSON 格式的数据。 由“信息平台”提供接口地址，企业实名制或考勤系统。 接口请求URL 地址：详见接口说明。 接口未注明处均使用UTF-8 编码。 通信过程中涉及的中文或特殊符号的传输，需进行urlencode 处理。 HTTP（或HTTPS）请求参数均为字符串。 接口请求需进行签名，详见 2.2 通信安全一节。 通信安全 为保证数据传输过程中的数据真实性，我们需要对数据进行数字签名，在接收签名数据之后进行签名校验。 “信息平台”会为施工企业的每个工程分配唯一的接入编号和接入密钥。签名机制如下： 对全部有长度限制的传输字段（不包括NL 类型的字段）进行签名，将参数名（区分大小写）和参数值（需进行urlencode 处理）用“=”连接，参数值为空的参数不参与签名，参数之间用“”连接，格式是：param1=val1param2=val2…。 参数组装顺序规则：参数名的字典顺序。 密钥拼接方式为传输参数直接连接密钥，如只有param1 和 param2 两参数，值分别为 val1 和 val2，密钥为 key，拼接结果为：param1=val1param2=val2key。 使用“信息平台”分配的密钥进行 MD5 加密（密钥直接跟在组装好的参数后即可）， 将值赋给 sign 参数。 敏感信息班组编号、身份证图片路径、身份证号、银行卡号、社保号需要加密传输， 使用 DES 加密，加密 key 等于接入密钥，加密后的字节码转为16 进制编码的字符串，并在密文字符串的前面加“des:”前缀。算法：密文=”des:” + HEX(DES(idcard, key))，如 ： 身 份 证 号 ：5113011990010181111， 接 入 密 钥 ： 8c2da4c769828fcfa77aedb690999cf9， 密 文 ： des:80cfe03525bb2b8d43d62ff369e95334cd1facfe4bbb800c PAGE PAGE 11 PAGE PAGE 12 注意事项 接口中各项参数当标识是M 时参数必选，为O 时可选。 接口字段长度分为三种：无限制（NL），固定长度（FL），可变长度（VL）。如果为 FL，则长度必须精确到FL 后跟随的数字，格式举例FL14；如果为VL，则长度在可变范围内即可，如果长度不够，不补空格或其它字符，格式举例VL30。 接口说明中，若参数字体为红色，请仔细阅读备注说明。 请求返回结果码不为 0 时，需要再次提交请求。如果结果码大于0，则需要根据提示信息修改错误后再次提交；如果结果码小于0，可以间隔一段时间再提交（如： 选择间隔 5 分钟、10 分钟、30 分钟、1 小时提交一次，连续 5 次提交不成功时推迟到第二天再提交）。 三、接口说明 所有接口响应的返回信息均以JSON 字符串形式返回，可以使用 JSON 工具包对 其进行解析。 其进行解析。 返回信息具体字段参照接口说明中的响应参数，以下以举例： 处理成功： {resultCode:0,resultDesc:处理成功} 处理失败： {resultCode:1,resultDesc:签名错误} 返回结果码对照见附录 4.2 结果码对照表。 新增班组 接口描述施工企业添加班组时调用 接口描述 施工企业添加班组时调用 请求地址 /smz/team/save 测试请求地址 请求参数 参数 accessNo 限制 M 长度 FL32 注释