API 参考

TronSave REST API 参考总览：基础 URL、v2 版本管理、API 密钥与签名交易两种身份验证方式、统一响应封装，以及购买资源、续期订单、出售资源等端点分组导航。

TronSave API 让你能够以编程方式在 TRON 网络上购买、续期和出售能量与带宽。每个端点都是通过 HTTPS 发起的 JSON REST 调用。

基础 URL

环境

API 基础 URL

生产环境

https://api.tronsave.io

测试网 (Nile)

https://api-dev.tronsave.io

端点通过路径前缀进行版本管理 —— 当前版本为 v2，例如 https://api.tronsave.io/v2/buy-resource。完整的主机和链列表请参阅环境与网络。

大多数写入端点都要求在 apikey 请求头中传入 API 密钥：

curl -X POST https://api.tronsave.io/v2/buy-resource \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

支付和授权订单有两种方式：

使用 API 密钥 —— 为 TronSave 内部账户充值，然后用你的 API 密钥对每个请求进行身份验证。快速、易于集成，并能节省交易费用，但资金会保存在由 TronSave 托管的内部账户中。
使用签名交易 —— 构建一笔交易，用你的私钥对其签名，然后提交。这能让你完全掌控资金并拥有更高的安全标准，但代价是链上交易费用和更复杂的集成。

关于如何获取密钥、为账户充值以及在两种方式之间做出选择，请参阅身份验证。

v2 是当前 API，也是本参考文档全篇所记录的版本。此前的 v0 API 仍可供现有集成使用。

新集成应使用 v2。旧版 v0 API 仅出于向后兼容的目的进行维护 —— 参见旧版 API (v0)。

每个 API 响应都被包装在一致的 JSON 封装中：

{
  "error": false,
  "message": "OK",
  "data": { }
}

字段

说明

error

布尔标志 —— 成功时为 false，失败时为 true。

message

人类可读的状态或错误消息。

data

响应载荷（对象）—— 其结构取决于具体端点。

关于错误代码、HTTP 状态映射和速率限制行为，请参阅错误与速率限制。

分组

功能

预估成本并创建订单以购买能量或带宽，可通过签名交易或 API 密钥进行。

查找可续期的代理（委托）并延长现有订单的时长。

列出并管理你向市场提供的资源。

快速补充资源 —— 预估、创建、跟踪、确认和取消订单。

使用 TronSave 的 Model Context Protocol 服务器从 AI 智能体驱动 API。

Last updated 1 month ago