Errors (错误码)

在本指南中,我们将讨论使用 API 时出现问题时会发生什么情况。错误是会发生的,而且大多数都是你的,而不是我们的。让我们看一下您可能会遇到的一些状态代码和错误类型。

您可以通过在收到 API 响应时检查状态代码来判断请求是否成功。如果响应返回不成功,您可以使用错误类型和错误消息来找出问题所在并进行一些基本调试(在联系支持之前)。


状态码(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": {}
}

Was this page helpful?