错误代码

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

错误响应格式

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

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

错误代码列表

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

处理错误

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

身份验证错误（代码1）

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

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

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

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

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

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

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

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