Recarga automática
Criar regra de largura de banda
Reabasteça a largura de banda de um endereço sempre que ela cair abaixo de um limiar
POST
Criar regra de largura de banda
Criar regra de largura de banda
Cria uma regra de Recarga automática para um endereço. A partir da verificação seguinte, sempre que o endereço tiver menos largura de banda disponível do quethreshold_bandwidth, compramos add_volume de largura de banda pela duration escolhida e cobramos do seu saldo. Veja a visão geral para entender como funcionam as verificações, o custo e os status.
A requisição apenas cria a regra — ela mesma não compra nada. Exige o escopo buy_bandwidth. Para ver antes o preço de uma recarga, use Cotação de recarga de largura de banda.
A largura de banda disponível conta tudo com que o endereço pode pagar uma transação: as 600 gratuitas por dia, mais qualquer largura de banda em stake ou delegada. Um limiar de 600 ou menos é atendido só pela cota gratuita, até que o endereço a gaste.
Corpo da requisição
string
obrigatório
Endereço TRON a manter abastecido (formato T…, 34 caracteres). Endereços de contrato são recusados.
number
obrigatório
Compra quando o endereço tem menos largura de banda disponível do que este valor. De 1 a 1.000.000.
number
obrigatório
Largura de banda a comprar por recarga. De 350 a 100.000. Mantenha-o igual ou acima de
threshold_bandwidth — veja o aviso na visão geral.string
padrão:"1h"
Duração do aluguel de cada recarga:
"1h" ou "1d".string
Um nome próprio para a regra, até 100 caracteres. Opcional.
Resposta
A nova regra — com os mesmos campos de Listar regras de largura de banda — mais dois campos sobre o estado atual do endereço:number | null
Largura de banda disponível no endereço no momento em que a regra foi criada, incluindo a gratuita.
null se não foi possível lê-la; a regra é criada de qualquer forma.boolean
true se current_bandwidth já está abaixo do limiar, de modo que a próxima verificação — normalmente em até um minuto — vai comprar. false se o endereço tem o suficiente ou se não foi possível ler o nível.Exemplo
Response
Erros
detail como array: