DOC《广州市建设领域管理应用信息平台》

三、接口说明 所有接口响应的返回信息均以JSON字符串形式返回,可以使用JSON工具包对其进行解析. 返回信息具体字段参照接口说明中的响应参数,以下以举例: 处理成功: {"resultCode":0,"resultDesc":"处理成功"} 处理失败: {"resultCode":1,"resultDesc":"签名错误"} 返回结果码对照见附录4.2结果码对照表. 3.1批量上报工人考勤 接口说明 接口描述 施工企业批量上报工人考勤 请求地址 /attendance/attendance/saves 测试请求地址 请求参数 参数 限制 长度 注释 备注 accessNo M FL32 接入编号 "信息平台"为施工企业分配的接入编号 dataList M NL 考勤数据列表 考勤数据列表.不参与签名.json格式的数据: [{ builderIdcard : '工人身份证号,使用DES加密', workDate : '考勤日期yyyyMMdd', workStart : '上班时间yyyyMMddHHmmss', workEnd : '下班时间yyyyMMddHHmmss' }] timestamp M FL17 时间戳 北京时间精确到毫秒(yyyyMMddHHmmssSSS) sign M FL32 签名 dataList不参与签名 响应参数 参数 限制 说明 resultCode M 返回结果码,数字类型.0表示成功;

其它表示失败. resultDesc O 返回结果描述 3.2实时上报工人考勤 接口说明 接口描述 施工企业实时上报工人考勤.工人必须存在. 请求地址 /attendance/attendance/save 测试请求地址 请求参数 参数 限制 长度 注释 备注 accessNo M FL32 接入编号 "信息平台"为施工企业分配的接入编号 builderIdcard M VL150 工人身份证号 检查工人是否存在的依据,使用DES加密 atteTime M FL17 考勤时间 yyyyMMddHHmmss atteImage O NL 考勤图片 取图片的二进制值,转成base64编码.不参与签名 timestamp M FL17 时间戳 北京时间精确到毫秒(yyyyMMddHHmmssSSS) sign M FL32 签名 atteImage不参与签名 响应参数 参数 限制 说明 resultCode M 返回结果码,数字类型.0表示成功;

其它表示失败. resultDesc O 返回结果描述

四、附录 4.1 测试环境 测试环境接入编号: 测试环境接入密钥: teamCode: builderIdcard: 4.2 结果码对照表 返回码 返回码文本介绍 说明

0 请求成功 当且仅当返回码为0时,请求成功

1 签名验证失败 签名错误

2 参数错误 参数长度或数据类型错误

3 接入编号错误 接入编号不存在

201 班组不存在 添加修改班组工人时返回

202 工人不存在 添加修改工人证书、添加修改班组工人时返回 -1 系统内部异常:[..],请稍候再试 系统内部异常,返回异常描述 4.3调用示例 将参数排序 (以Java TreeMap实现参数名按ASCII字典顺序排序) TreeMap params = new TreeMap();

params.put("param1", urlencode("value1", "UTF-8"));

params.put("param2", urlencode("value2", "UTF-8"));

将参数拼接成字符串 (空值不参与签名) String str = "";

for(param : params){ if(param.value != null && param.value.length() > 0){ str param.key + "=" + param.value;

} } str = str.substring(1, str.length());

生成签名 String sign = md5(str + key);

params.put("sign", sign);

提交数据 http.post(params);