Saltar al contenido principal
POST
Crear regla de ancho de banda

Crear regla de ancho de banda

Crea una regla de Recarga automática para una dirección. A partir de la siguiente comprobación, cada vez que la dirección tenga menos ancho de banda disponible que threshold_bandwidth, compramos add_volume de ancho de banda por la duration elegida y lo cobramos de tu saldo. Consulta la descripción general para ver cómo funcionan las comprobaciones, el coste y los estados. La solicitud solo crea la regla — no compra nada por sí misma. Requiere el alcance buy_bandwidth. Para ver antes el precio de una recarga, usa Cotización de recarga de ancho de banda.
El ancho de banda disponible cuenta todo aquello con lo que la dirección puede pagar una transacción: los 600 gratuitos al día más cualquier ancho de banda obtenido por stake o recibido por delegación. Un umbral de 600 o menos se cumple solo con la asignación gratuita hasta que la dirección la gasta.

Cuerpo de la solicitud

string
requerido
Dirección TRON que se mantendrá abastecida (formato T…, 34 caracteres). Las direcciones de contrato se rechazan.
number
requerido
Se compra cuando la dirección tiene menos ancho de banda disponible que este valor. De 1 a 1,000,000.
number
requerido
Ancho de banda que se compra en cada recarga. De 350 a 100,000. Mantenlo igual o por encima de threshold_bandwidth — consulta la advertencia de la descripción general.
string
predeterminado:"1h"
Duración del alquiler de cada recarga: "1h" o "1d".
string
Tu propio nombre para la regla, hasta 100 caracteres. Opcional.

Respuesta

La nueva regla — con los mismos campos que en Listar reglas de ancho de banda — más dos campos sobre el estado actual de la dirección:
number | null
Ancho de banda disponible en la dirección en el momento de crear la regla, ancho de banda gratuito incluido. null si no se pudo leer; la regla se crea de todos modos.
boolean
true si current_bandwidth ya está por debajo del umbral, de modo que la siguiente comprobación — normalmente en menos de un minuto — comprará. false si la dirección tiene suficiente, o si no se pudo leer el nivel.

Ejemplo

Response

Errores

Un error de validación llega en el formato del framework, con detail como array:
Reintentar una creación tras agotarse el tiempo de espera es seguro. Si la primera solicitud se completó, el reintento devuelve 409 AUTOREFILL_ADDRESS_TAKEN en lugar de crear una segunda regla; lista tus reglas para obtener su id.