Recarga automática
Criar regra de energia
Reabasteça a energia de um endereço sempre que ela cair abaixo de um limiar
POST
Criar regra de energia
Criar regra de energia
Cria uma regra de Recarga automática para um endereço. A partir da verificação seguinte, sempre que o endereço tiver menos energia disponível do quethreshold_energy, compramos add_volume de energia por uma hora 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_energy. Para ver antes o preço de uma recarga, use Cotação de recarga de energia.
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 energia disponível do que este valor. De 1 a 50.000.000.
number
obrigatório
Energia a comprar por recarga. De 32.000 a 5.000.000. Mantenha-o igual ou acima de
threshold_energy — veja o aviso na visão geral.string
padrão:"1h"
Duração do aluguel de cada recarga. Apenas
"1h" é aceito; qualquer outro valor retorna 422.string
Um nome próprio para a regra, até 100 caracteres. Opcional.
Resposta
A nova regra — com os mesmos campos de Listar regras de energia — mais dois campos sobre o estado atual do endereço:number | null
Energia disponível no endereço no momento em que a regra foi criada.
null se não foi possível lê-la; a regra é criada de qualquer forma.boolean
true se current_energy 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: