状态码一览表
状态码 | 描述 |
---|---|
1000 | 请求成功且数据已返回,success 为 true |
1001 | 请求被拦截,您可查看 msg 字段了解原因,success 为 false |
1002 | 您传递的参数有问题,请检查参数格式,success 为 false |
1003 | 系统业务逻辑出现异常,数据缺失或者数据错误,success 为 false |
1004 | 系统内部服务器出现异常,success 为 false |
1005 | 其他异常,success 为 false |
当 API 请求由于权限不足、服务过期等原因导致错误时,API 会返回如下结构的错误信息。你的程序可以根据 success 和 code 来进行相应的处理。下面列举了几种常见的情况。
- 应用到期,提示续费充值
{
"code": "1001",
"msg": "应用已到期,请重新续费充值后使用。",
"success": false
}
- 应用调用次数用尽
{
"code": "1001",
"msg": "调用次数已用尽,请尽快续费充值后使用。",
"success": false
}
- 应用配置了白名单,但当前发起调用的机器未在白名单内,被拦截
{
"code": "1001",
"msg": "您配置了IP白名单策略,当前IP未在白名单内。",
"success": false
}
- 由于您的恶意调用,导致应用被封禁
{
"code": "1001",
"msg": "由于恶意调用或者触犯了平台相关条例,您的应用已被封禁。",
"success": false
}
- 请求方式错误,比如接口规定是 GET 请求,你用 POST 方式请求
{
"code": "1004",
"msg": "当前请求方式错误,请按照开放文档自行检查接口请求方式",
"success": false
}
- 服务器节点内部异常,请联系官方技术人员解决
{
"code": "1004",
"msg": "网关出了点问题,请稍后重试",
"success": false
}
- 服务器业务异常,请联系官方技术人员解决
{
"code": "1003",
"msg": "服务器业务异常,请联系技术人员",
"success": false
}