故障排查
购买能量或与 TronSave 集成时最常见问题的解决方法——订单未成交、余额不足、速率限制、ZapBuy 交付以及网络错误。
本页汇总了最常见的集成与购买问题、你会看到的确切错误字符串，以及解决方法。如需完整的机器可读 API 错误码列表，请参阅错误与速率限制。
订单未成交
当你创建一个需要立即完全匹配的订单，但市场无法提供其 100% 的供应时，API 会返回 HTTP 400 并附带：
{
"CANNOT_FULFILLED": "The order requires an immediate full match, but the system cannot fulfill 100% of it."
}这通常意味着以下情况之一：
在你的价格下供应不足。 市场没有足够的能量可在等于或低于你的
unitPrice的价格上提供。你的价格上限过低。 如果预估价格超过
options.maxPriceAccepted，你将会收到PRICE_EXCEED_MAX_PRICE_REQUIRED。
如何修复：
允许部分成交（
allowPartialFill），使订单匹配当前可用的部分，而不要求立即 100% 成交。在提交前使用 Estimate TRX 重新核对价格，然后将
unitPrice设置为返回的值。对于市场无法一次性匹配的大额租赁，请使用智能订单（最低 10,000,000 能量，最短 3 天时长），它会随着时间推移持续进行更多匹配。
如果你不需要立即交付，请使用挂单，它会在订单簿中等待，直到市场能够匹配你的价格。
在机器人/Telegram 上，订单始终以 MEDIUM 价格提交，以保证 100% 匹配，因此机器人购买的成本可能高于你在网站上设置最低可能价格的订单。这两个价格仅在系统资源短缺时才会出现差异。
“挂单已存在”
你已经有一个参数完全相同的挂单。请等待它成交（或取消它），再重新提交相同的订单，或者更改某个参数（例如 unitPrice）。
余额不足
订单从你的内部账户余额中支付。如果余额不足，你会看到 HTTP 400：
如何修复： 在创建订单前为你的内部账户充值。如果该账户本身尚不存在，你会看到：
请先创建/充值账户，然后重试。
触发速率限制（HTTP 429）
大多数端点允许每秒 15 次请求；少数端点更低。超出限制会返回 HTTP 429：
如何修复： 退避并在你的每秒预算内重试。简单的指数退避（等待 1 秒，然后 2 秒，再 4 秒）通常就足够了。各端点的限制请参阅错误与速率限制。
认证失败（HTTP 401）
API_KEY_REQUIRED— 请求中缺少apikey头。INVALID_API_KEY— 密钥存在但不正确（拼写错误、已吊销，或来自不同环境）。
如何修复： 确认已设置 apikey 头并且与有效密钥匹配。请参阅认证。
在测试网上签发的密钥无法用于主网，反之亦然。请确保密钥与你正在调用的环境匹配。
通过 ZapBuy 未收到能量
使用 ZapBuy 时，你将 TRX 发送到 TronSave 机器人地址，系统会自动为发送钱包创建一个 1 小时的能量租赁。如果没有收到能量，请逐项检查以下内容：
你至少发送了最低金额。 ZapBuy 要求至少租赁 65,000 能量。低于该值的请求会被忽略，且不会创建订单。
你从普通钱包发送。 能量会被代理（委托）回发送地址，该地址必须是普通钱包——而非智能合约或交易所钱包。
交易已确认。 交易必须在 TRON 区块链上成功确认。
订单能够立即匹配。 ZapBuy 仅在当前有可用能量时才会成交。如果找不到匹配，你将不会收到能量。
你将正确的代币发送到了正确的地址。 ZapBuy 仅接受 TRX，发送到 TronSave 机器人地址：
如果你满足上述所有条件但仍未收到能量，请立即携带你的交易详情联系 TronSave 以请求帮助或退款：https://t.me/wantingtrx。
网络错误
发送到错误的网络是“丢失”资金和能量未交付最常见的原因。
在非 TRON 网络上发送 TRX。 ZapBuy 和内部账户充值仅接受 TRON 网络上的原生 TRX。通过其他链（或包装/跨链桥代币）发送的资金不会入账。
API 调用打到了错误的环境。 测试网和主网有各自独立的基础 URL 和独立的 API 密钥。用测试网密钥（或 URL）调用主网会产生
INVALID_API_KEY或意外的空结果。请对照环境核实你的基础 URL 和密钥。
请务必再次核对你要代理（委托）能量到的目标地址。目标地址不一致也可能是机器人购买与网站之间价格差异的原因。
快速参考
400
CANNOT_FULFILLED
允许部分成交、调整价格，或使用智能订单/挂单。
400
PRICE_EXCEED_MAX_PRICE_REQUIRED
重新预估并提高 options.maxPriceAccepted。
400
MUST_BE_WAIT_PREVIOUS_ORDER_FILLED
等待现有订单，或更改某个参数。
400
INTERNAL_BALANCE_ACCOUNT_TOO_LOW
为你的内部账户充值。
400
INTERNAL_ACCOUNT_NOT_FOUND
先创建/充值内部账户。
401
API_KEY_REQUIRED / INVALID_API_KEY
为正确的环境设置有效的 apikey 头。
429
RATE_LIMIT
退避并使用指数退避重试。
后续步骤
Last updated