跳转到主要内容

​
错误格式

所有错误返回包含 detail 字段的 JSON 响应： 
{
  "detail": "Insufficient balance"
}
部分错误包含结构化的 code，用于程序化处理： 
{
  "detail": {
    "error": {
      "code": "INSUFFICIENT_BALANCE",
      "message": "Not enough TRX balance"
    }
  }
}

​
HTTP 状态码

状态码含义
200成功
400错误请求 — 参数无效
401未授权 — API 密钥缺失或无效
403禁止访问 — 密钥已禁用或操作不被允许
404未找到
409冲突 — 重复请求或资源冲突
422验证错误 — 请检查请求体
429超出速率限制
500服务器错误

​
常见错误代码

代码描述
INSUFFICIENT_BALANCE账户余额不足
ADDRESS_ALREADY_ACTIVE该地址已激活智能模式
ORDER_NOT_FOUND订单 ID 不存在
INVALID_ADDRESS不是有效的 TRON 地址
RATE_LIMITED请求过多，请在冷却后重试
PASSKEY_REQUIRED提现需要通行密钥验证
2FA_REQUIRED提现需要双重验证码

​
重试策略

对于 429 和 5xx 错误，请实现指数退避重试： 
import time
import requests

def api_call_with_retry(url, **kwargs):
    for attempt in range(3):
        resp = requests.get(url, **kwargs)
        if resp.status_code == 429 or resp.status_code >= 500:
            time.sleep(2 ** attempt)
            continue
        return resp
    raise Exception("Max retries exceeded")