Saltar al contenido principal

​
Autenticacion con clave API

Todas las solicitudes a la API requieren una clave API proporcionada en el encabezado X-API-Key.

​
Obtener una clave API

  1. Registrate en tronrental.com
  2. Ve a Panel de control → Claves API
  3. Haz clic en Crear clave API
  4. Copia y almacena tu clave de forma segura — solo se muestra una vez

​
Lista blanca de IP (opcional)

Puedes restringir tu clave API a direcciones IP especificas para mayor seguridad. Configura esto en el panel de control al crear o editar una clave.

​
Permisos de la clave

Cada clave API lleva alcances (scopes): las operaciones que puede realizar. Los eliges en el panel al crear o editar una clave. Una clave nueva recibe todos los alcances de lectura y escritura (comprar energía y ancho de banda, Smart Mode, consultar el saldo y el historial, entre otros) salvo withdraw: ese alcance se activa por separado y requiere 2FA y una lista blanca de IP. Una solicitud fuera de los alcances de la clave se rechaza con HTTP 403. La lista completa: Listar alcances de clave API.
Mantiene tu clave API en secreto. No la expongas en codigo del lado del cliente, repositorios publicos o URLs.

​
Claves de Node API

Node API — acceso a nodos completos de TRON en node.tronrental.com — tiene claves propias. Se crean como endpoints en Panel → Node API. Una clave de Node API solo funciona en el nodo: esta API la rechaza con 403 NODE_API_KEY_ONLY. Las claves API descritas en esta página tampoco funcionan en el nodo. Consulta Node API → Endpoints y claves.

​
Uso de la clave y registro de solicitudes

Cada solicitud autenticada con una clave API se guarda durante 7 días: método, ruta, código de estado, latencia e IP del cliente. Los parámetros de consulta no se muestran en esta vista. Abra Dashboard → API Keys y despliegue una clave para ver sus solicitudes recientes; la columna Last Used muestra la llamada más reciente (la marca de autenticación se actualiza como máximo una vez cada 5 minutos; el registro es exacto). El registro solo está disponible desde el panel: una clave API no puede leer su propio registro.

​
Limites de tasa

El limite de tasa se cuenta por cuenta, no por clave: todas las claves de una cuenta comparten un unico presupuesto. Consulta Limites de tasa para mas detalles.

​
Errores

Los errores de autenticacion devuelven HTTP 401:
Si tu clave esta deshabilitada o bloqueada, recibiras HTTP 403.