Skip to content

响应通用格式

开放平台返回的请求,符合如下的通用格式:

json
{
  "status": 10000,
  "msg": "OK",
  "trace_id": "0aab11f468944f7717dbdcbd25524802",
  "results": ...
}

通用字段包括:

  • status: 响应状态码,见下表
  • msg: 响应的通用信息,例如失败后的具体错误信息
  • trace_id:该请求的唯一编号,用于排查问题。对于接口返回的字段问题,开发者若提供具体的trace_id信息,可便于我方定位。
  • results:和API相关返回的具体内容,会被填充至results字段中。

响应错误码

说明
10000请求正常
10001key不正确或过期
10002没有权限使用相应的服务或者请求接口的路径拼写错误
10003访问已超出日访问量
10004单位时间内访问过于频繁
10005IP白名单出错,发送请求的服务器IP不在IP白名单内
10006绑定域名无效
10007数字签名未通过验证
10008MD5安全码未通过验证
10009请求key与绑定平台不符
10010IP访问超限
10011服务不支持https请求
10012权限不足,服务请求被拒绝
10013Key被删除
10014云图服务QPS超限
10015受单机QPS限流限制
10016服务器负载过高
10017所请求的资源不可用
10019使用的某个服务总QPS超限
10020某个Key使用某个服务接口QPS超出限制
10021账号使用某个服务接口QPS超出限制
10026账号处于被封禁状态
10029某个Key的QPS超出限制
10041请求的接口权限过期
10044账号维度日调用量超出限制
10045账号维度海外服务日调用量超出限制
20000请求参数非法
20001缺少必填参数
20002请求协议非法
20003其他未知错误
20011查询坐标或规划点在海外,但没有海外地图权限
20012查询信息存在非法内容
20800规划点不在中国陆地范围内
20801划点附近搜不到路
20802路线计算失败,通常是由于道路连通关系导致
20803起点终点距离过长
30000服务响应失败
40000余额耗尽
40001围栏个数达到上限
40002购买服务到期
40003海外服务余额耗尽