Errors (错误码)
在本指南中,我们将讨论使用 API 时出现问题时会发生什么情况。错误是会发生的,而且大多数都是你的,而不是我们的。让我们看一下您可能会遇到的一些状态代码和错误类型。
您可以通过在收到 API 响应时检查状态代码来判断请求是否成功。如果响应返回不成功,您可以使用错误类型和错误消息来找出问题所在并进行一些基本调试(在联系支持之前)。
在因错误而联系支持之前,请注意 99% 报告的错误实际上是用户错误。因此,请仔细检查 在联系协议支持之前您的代码。
状态码(Status codes)
以下是协议 API 返回的不同类别状态代码的列表。使用这些来了解请求是否成功。
- Name
0
- Description
- 状态代码表示响应成功
- Name
100
- Description
- 请求参数错误
- Name
11000
- Description
- 操作失败,请稍后再试
- Name
11001
- Description
- 操作过于频繁
- Name
11003
- Description
- 缺少必要参数
- Name
12002
- Description
- 订单不存在
- Name
20000
- Description
- 应用不存在
- Name
20001
- Description
- 无效的API密钥
- Name
20002
- Description
- 账户余额不足
- Name
20003
- Description
- 配额不足
- Name
20004
- Description
- 请求频率受限
- Name
20005
- Description
- 接收地址无效
- Name
20006
- Description
- 能量参数无效
- Name
20007
- Description
- 质押金额无效
- Name
20008
- Description
- 租用时长无效
- Name
20009
- Description
- 资源剩余不足
- Name
20010
- Description
- 无效的时间单位,仅支持 h/d
- Name
20011
- Description
- 无效参数
- Name
20012
- Description
- IP不在白名单
错误类型(Error types)
每当请求不成功时,协议 API 将返回一个错误响应,其中包含错误类型和消息。您可以使用此信息更好地了解出了什么问题以及如何修复它。大多数错误消息都非常有帮助且可操作。
Error response
{
"code": 100,
"msg": "请求参数错误",
"time":1737195360794,
"data": {}
}