Saltar para o conteúdo principal
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 que threshold_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

Um erro de validação vem no formato do framework, com detail como array:
Repetir uma criação após um timeout é seguro. Se a primeira requisição foi processada, a repetição retorna 409 AUTOREFILL_ADDRESS_TAKEN em vez de criar uma segunda regra; liste as suas regras para obter o id dela.