错误代码

本页面提供了TronZap API可能返回的错误代码信息。

错误响应格式

发生错误时，API将返回包含非零错误代码和错误消息的响应：

{
    "code": 1,
    "error": "错误消息描述"
}

错误代码列表

代码	描述	解决方案
0	成功	这不是错误。请求成功。
1	身份验证错误	检查您的API令牌并确保签名计算正确。
2	无效的服务或参数	检查服务名称和参数是否正确。
5	未找到钱包	验证钱包地址，如果您认为这是错误，请联系支持。
6	余额不足	向您的账户添加资金或减少您要求的能量数量。
10	无效的波场地址	检查波场地址格式。它应该是有效的34字符波场地址。
11	无效的能量数量	确保请求的能量数量有效。
12	无效的持续时间	检查持续时间参数是否有效。
20	未找到订阅	验证订阅ID或外部ID是否正确。
21	无法停止订阅	检查订阅限制；调整交易限额或完成待处理交易。
24	地址未激活	首先通过进行地址激活交易来激活地址。
25	地址已激活	地址已激活。无需操作。
30	未找到AML检查	重新执行AML检查或联系支持确认验证状态。
35	服务不可用	该服务暂时不可用。
500	内部服务器错误	如果此错误持续存在，请联系支持。

处理错误

在使用API时，您应该为所有可能的错误代码实现错误处理逻辑。以下是一些建议：

身份验证错误（代码1）

身份验证错误表示您的API凭据或签名计算存在问题。您应该：

• 验证您的API令牌是否正确
• 检查您的签名计算逻辑
• 确保您的API密钥不会暴露在客户端代码中

资源错误（代码5、6、10、20）

资源错误表示提供的资源存在问题。您应该：

• 在将波场地址发送到API之前验证它们
• 在进行交易之前检查账户余额
• 检查状态时验证交易ID

业务逻辑错误（代码24、25）

业务逻辑错误表示请求的操作存在问题。您应该：

• 在尝试能量购买之前实现地址激活检查
• 如果已激活则跳过地址激活