跳转到主要内容

API 密钥验证

所有 API 请求需要在 X-API-Key 请求头中传入 API 密钥。

获取 API 密钥

  1. 在 tronrental.com 注册
  2. 前往控制面板 → API 密钥
  3. 点击 创建 API 密钥
  4. 复制并安全保存您的密钥 — 密钥仅显示一次

IP 白名单(可选)

您可以将 API 密钥限制为特定 IP 地址,以提高安全性。在创建或编辑密钥时,可在控制面板中进行配置。

密钥权限

每个 API 密钥都带有权限(scopes),即它可以执行的操作。您在控制台创建或编辑密钥时选择这些权限。新密钥获得全部读取和写入权限(购买能量和带宽、智能模式、查询余额和历史等),但不包括 withdraw:该权限需单独开启,并要求启用 2FA 和 IP 白名单。超出密钥权限的请求会被拒绝,返回 HTTP 403。完整列表见列出 API 密钥权限。
请妥善保管您的 API 密钥。请勿在客户端代码、公开仓库或 URL 中暴露密钥。

Node API 密钥

Node API——在 node.tronrental.com 访问 TRON 全节点——有自己的密钥。您可以在控制台 → Node API 中以端点的形式创建它们。 Node API 密钥只能在节点上使用:本 API 会以 403 NODE_API_KEY_ONLY 拒绝它。本页介绍的 API 密钥同样不能在节点上使用。参见 Node API → 端点与密钥。

密钥使用情况与请求日志

每一次使用 API 密钥认证的请求都会保留 7 天:方法、路径、状态码、延迟和客户端 IP。此视图不显示查询参数。打开 Dashboard → API Keys 并展开密钥即可查看其最近的请求;Last Used 列显示最近一次调用(认证时的标记最多每 5 分钟更新一次,请求日志则是精确的)。日志仅在控制台中可用——API 密钥无法读取自己的日志。

速率限制

速率限制按账户计算,而非按密钥:同一账户的所有密钥共用一份配额。详情请参阅速率限制。

错误

身份验证错误将返回 HTTP 401:
如果您的密钥已被禁用或封锁,将收到 HTTP 403。