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

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.