跳到主要内容

API 教程

通过我们的 REST API 将 TRON 能量租赁服务集成到您的应用程序中。

开始使用​

我们的 REST API 允许您以编程方式访问 TRON 能量租赁服务。API 提供基于身份验证的产品列表、能量转移和账户管理访问。

功能特点​

  • 🔑 身份验证 - 基于用户的身份验证系统
  • 📦 产品管理 - 列出可用的能量产品
  • ⚡ 能量转移 - 将能量转移到用户账户
  • 💰 账户余额 - 检查用户账户余额
  • 🏥 健康监控 - API 健康检查端点

身份验证​

TRON 能量租赁 API 的身份验证通过在每个请求的 Authorization 标头中提供的 Bearer 令牌进行处理。

要获取您的 API 令牌，请使用我们的官方 。在 Telegram 中完成身份验证过程后，机器人将为您提供会话令牌。

在所有 API 请求的 Authorization 标头中包含您的令牌：

API 端点​

获取能量产品列表​

GET /product/getEnergyProduct

检索可用能量产品列表

请求参数​

示例请求​

curl -X GET "https://{host}/product/getEnergyProduct" \
  -H "Authorization: AUTH_TOKEN"

响应​

{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "id": 1,
            "name": "2 TRX",
            "description": "购买能量。转移TRX即可立即获得能量。最低购买金额为65000能量。2.5 TRX = 65000能量，5 TRX = 131000能量。最高转移金额为50 TRX = 1310000能量。程序全天候运行，响应速度极快，仅需毫秒。",
            "duration": 1,
            "status": 1,
            "trx_amount": 2.0,
            "engery": 65000.0,
            "bandwith": 0.0,
            "create_time": "2025-03-24 09:01:32",
            "update_time": "2025-09-12 10:57:15",
            "type": 1,
            "trx_ratio": null,
            "transactions": null
        }
    ]
}

GET /product/getTransactionProduct

检索可用的基于交易的产品列表

请求参数​

示例请求​

curl -X GET "https://{host}/product/getTransactionProduct" \
  -H "Authorization: AUTH_TOKEN"

响应​

{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "id": 10,
            "name": "1 笔",
            "description": "1笔 65000能量",
            "duration": 1,
            "status": 1,
            "trx_amount": 2.0,
            "engery": 65000.0,
            "bandwith": 0.0,
            "create_time": "2025-06-27 12:49:16",
            "update_time": "2025-09-12 10:58:43",
            "type": 2,
            "trx_ratio": null,
            "transactions": null
        }
    ]
}

GET /product/getSmartProduct

检索可用的智能产品列表

请求参数​

示例请求​

curl -X GET "https://{host}/product/getSmartProduct" \
  -H "Authorization: AUTH_TOKEN"

响应​

{
    "code": 200,
    "message": "Success",
    "data": [
        {
            "id": 50,
            "name": "5笔",
            "description": "5笔",
            "duration": 0,
            "status": 1,
            "trx_amount": 15.0,
            "engery": 235200.0,
            "bandwith": 0.0,
            "create_time": "2025-07-28 00:50:56",
            "update_time": "2025-08-19 10:54:43",
            "type": 6,
            "trx_ratio": null,
            "transactions": 5
        }
    ]
}

转移能量​

POST /rental/getEnergy

根据选定的产品将能量转移到已认证用户的账户。

请求参数​

参数类型必需描述
productIdLong是要购买的产品 ID

示例请求​

curl -X POST "https://api.tron-energy-rental.com/rental/getEnergy" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "Authorization: AUTH_TOKEN" \
  -d "productId=1"

响应​

{
  "code": 200,
  "message": "Success",
  "data": null
}

获取账户余额​

GET /account/balance

检索已认证用户账户的当前余额。

示例请求​

curl -X GET https://api.tron-energy-rental.com/account/balance \
  -H "Authorization: AUTH_TOKEN"

响应​

{
  "code": 200,
  "message": "Success",
  "data": {
    "balance": 150.75
  }
}

响应格式​

所有 API 响应都遵循一致的格式：

{
  "code": 200,
  "message": "Success",
  "data": {}
}

响应字段​

字段类型描述
codeintegerHTTP 状态码 (200 表示成功)
messagestring人类可读的状态消息
dataobject响应数据 (因端点而异)

错误处理​

API 返回标准 HTTP 状态码和详细的错误消息：

状态码描述
200成功
401未授权 - 用户未认证
404未找到 - 资源未找到
500内部服务器错误

错误响应格式​

{
  "code": 401,
  "message": "Unauthorized: Invalid or missing API key"
}

身份验证流程​

  1. Telegram 机器人: 用户通过我们的官方 进行身份验证
  2. 令牌生成: 成功身份验证后，机器人提供 AUTH_TOKEN
  3. API 访问: 在 API 请求的 Authorization 标头中使用 AUTH_TOKEN
  4. 用户上下文: API 自动从令牌识别用户

测试​

使用我们的开发环境进行测试：

  • 测试 URL: 从我们的 获取我们的测试 URL
  • 生产 URL: 从我们的 获取我们的生产 URL
  • 身份验证: 从我们的 获取您的 AUTH_TOKEN

支持​

需要 API 集成帮助？

准备集成？ 联系支持 开始 API 访问。