引言 接口对接步骤 通讯协议 Token/Key说明 规则详情 对接解决方案 接口Post地址 接口报错自查 字典表集合1 字典表集合2

接口参数注意事项

接口参数说明和注意事项

1、图片参数:符合图片Kb大小,且图片格式为:".jpg",".png",".jpeg",".bmp"。图片转Base64编码。

2、项目所在区域或公司注册地的行政区划代码:只取区县级的行政区划代码的前六位。如北京市/市辖区/东城区的区划代码为110101000000,则只取前六位为110101。区域代码查询的参考:区域代码查询

3、银行联号:开户行联行行号即为银行联号,开户行名称即为银行支行名称。参考地址:银行联号查询

4、接口说明中,若参数字体为红色,请仔细阅读备注说明。

5、工人考勤对接时,工人打卡时间离监管平台接收RequestBody数据之间的间隔不超过10分钟。超过10分钟的工人考勤数据会被标记为“考勤记录数据”,而不是“实时考勤数据”。

6、无特殊说明,则字段数据类型均为string。有数据格式说明的,则需要根据具体参数类型变动。

7、请求时Content-Type: application/json;charset=utf-8。

8、requestJson对象参数中,若有字段经过DES加密、图片转Base64处理的,则UrlEncode后再赋值上传。

接口对接的常见问题

请求体RequestBody错误

1,错误请求,无法解析数据对象

解决方案:检查请求时Content-Type;请求体RequestBody与目标接口RequestBody对象是否匹配;请求体RequestBody以及requestJson对象参数各项参数值是否符合对应目标接口的参数规则

请求体RequestBody的参数报错

1,date请求时间格式不符合。

2,date请求时间超时。

3,签名失败。

解决方案:仔细查看RequestBody的各参数的规则与说明;核对请求时间,不能大于当前互联网北京时间,不能小于当前互联网北京时间5分钟。

requestJson具体对象参数报错

1,DES加密字段无法解析成功,如身份证号码错误、验证失败。

2,图片base64参数解析失败、保存失败。

解决方案:仔细检查DES加密、图片base64后的字段,是否有经过Urlencode处理后再赋值,后再上传;检查参数字段的数据格式要求;检查图片字段的base64编码是否符合规则。

对接公司类型错误

1,未有目标接口的请求操作权限

解决方案:仔细检查对应接口上传的token是否有操作权限。

token不存在或找不到对应项目/公司信息

解决方案:登录监管平台-测试系统,检查测试项目是否存在;检查测试项目是否被审核通过(未审核通过的测试项目请联系建信开太平技术人员);查看测试Token对应的接口状态是否为正常。