接口参数注意事项
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后再赋值上传。
接口对接的常见问题
1,错误请求,无法解析数据对象
解决方案:检查请求时Content-Type;请求体RequestBody与目标接口RequestBody对象是否匹配;请求体RequestBody以及requestJson对象参数各项参数值是否符合对应目标接口的参数规则
1,date请求时间格式不符合。
2,date请求时间超时。
3,签名失败。
解决方案:仔细查看RequestBody的各参数的规则与说明;核对请求时间,不能大于当前互联网北京时间,不能小于当前互联网北京时间5分钟。
1,DES加密字段无法解析成功,如身份证号码错误、验证失败。
2,图片base64参数解析失败、保存失败。
解决方案:仔细检查DES加密、图片base64后的字段,是否有经过Urlencode处理后再赋值,后再上传;检查参数字段的数据格式要求;检查图片字段的base64编码是否符合规则。
解决方案:登录监管平台-测试系统,检查测试项目是否存在;检查测试项目是否被审核通过(未审核通过的测试项目请联系建信开太平技术人员);查看测试Token对应的接口状态是否为正常。