建享云智能安全帽开放接口(Open API)6

0 阅读1分钟

六、通用说明 错误码 错误码 说明 200 请求成功 400 请求参数错误 401 签名验证失败 403 无访问权限 404 资源不存在 500 服务器内部错误 429 请求频率过高 code返回值 值 说明 500 时间戳超出有效期范围 1001 请求成功,正常返回数据 1002 请求成功,但有需要注意的问题,请查看msg字段值 1003 请求失败,发生错误 日期时间格式 所有时间字段均使用ISO 8601格式:YYYY-MM-DD hh:mm:ss 所有日期字段均使用ISO 8601格式:YYYY-MM-DD 数据格式说明 ● 所有接口返回数据格式为 ● 分页接口统一返回结构(包装在{"code": 1001, "msg": "...", "data": ...}的data字段中): { "rows": [...], "hasMore": true } ● 非分页列表接口(如轨迹)的data字段直接为数组 [...] ● 单一实体接口(如实时状态)的data字段直接为对象 {...} 调用频率限制 ● 每个接口限制10秒调用一次 注意事项

  1. 所有时间参数请使用UTC时间
  2. 签名验证时,服务器会检查时间戳与当前时间的差值,超过5秒的请求将被拒绝
  3. 随机字符串(nonce)在5秒内不能重复使用
  4. 单次请求最大返回记录数为500条
  5. 对象类型字段(如coordinates、photoUrls等)的具体结构请参考详细接口说明