Appearance
响应通用格式
开放平台返回的请求,符合如下的通用格式:
json
{
"status": 10000,
"msg": "OK",
"trace_id": "0aab11f468944f7717dbdcbd25524802",
"results": ...
}通用字段包括:
- status: 响应状态码,见下表
- msg: 响应的通用信息,例如失败后的具体错误信息
- trace_id:该请求的唯一编号,用于排查问题。对于接口返回的字段问题,开发者若提供具体的
trace_id信息,可便于我方定位。 - results:和API相关返回的具体内容,会被填充至
results字段中。
响应错误码
| 值 | 说明 |
|---|---|
| 10000 | 请求正常 |
| 10001 | key不正确或过期 |
| 10002 | 没有权限使用相应的服务或者请求接口的路径拼写错误 |
| 10003 | 访问已超出日访问量 |
| 10004 | 单位时间内访问过于频繁 |
| 10005 | IP白名单出错,发送请求的服务器IP不在IP白名单内 |
| 10006 | 绑定域名无效 |
| 10007 | 数字签名未通过验证 |
| 10008 | MD5安全码未通过验证 |
| 10009 | 请求key与绑定平台不符 |
| 10010 | IP访问超限 |
| 10011 | 服务不支持https请求 |
| 10012 | 权限不足,服务请求被拒绝 |
| 10013 | Key被删除 |
| 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 | 海外服务余额耗尽 |