1、1广州市建设领域管理应用信息平台建筑工人考勤数据接口标准2目录一、引言 .11.1 编写目的 .11.2 适用范围 .11.3 简称和术语 .1二、开发规范 .22.1 通信协议 .22.2 通信安全 .22.3 注意事项 .2三、接口说明 .43.1 批量上报工人考勤 .43.2 实时上报工人考勤 .5四、附录 .54.1 测试环境 .54.2 结果码对照表 .51一、引言1.1 编写目的为实现广州市建设领域管理应用信息平台对项目从业人员实名制管理和工人工资分账管理,考虑到部分项目已经在使用一些商业化实名制管理系统,为避免数据重复登记、减少系统改造成本,特编写本接口文档以供施工企业相关技术人
2、员对接。1.2 适用范围本文档的适用对象为接入广州市建设领域管理应用信息平台的施工企业技术开发人员、日常维护人员。1.3 简称和术语广州市建设领域管理应用信息平台:以下简称“信息平台”施工企业:指依法取得施工企业资质证书,在本市从事建设施工活动的施工总承包企业、专业承包企业和劳务分包企业2二、开发规范2.1 通信协议 采用 HTTP(或 HTTPS)协议进行请求和响应的处理。接口请求采用 GET/POST 方式。接口响应返回 JSON 格式的数据。 由“信息平台”提供接口地址,企业实名制或考勤系统调用。 接口请求 URL 地址:详见接口说明。 接口未注明处均使用 UTF-8 编码。 通信过程中
3、涉及的中文或特殊符号的传输,需进行 urlencode 处理。 HTTP(或 HTTPS)请求参数均为字符串。 接口请求需进行签名,详见 2.2 通信安全一节。2.2 通信安全为保证数据传输过程中的数据真实性,我们需要对数据进行数字签名,在接收签名数据之后进行签名校验。“信息平台”会为施工企业的每个工程分配唯一的接入编号和接入密钥。签名机制如下: 对全部有长度限制的传输字段(不包括 NL 类型的字段)进行签名,将参数名(区分大小写)和参数值(需进行 urlencode 处理)用“=”连接,参数值为空的参数不参与签名,参数之间用“params.put(“param1”, urlencode(“value1”, “UTF-8”);params.put(“param2”, urlencode(“value2”, “UTF-8”);2、 将参数拼接成字符串 (空值不参与签名)String str = “;for(param : params)if(param.value != null str = str.substring(1, str.length();3、 生成签名String sign = md5(str + key);params.put(“sign“, sign);4、 提交数据http.post(params);