Автопополнение
Создать правило для bandwidth
Пополнение bandwidth на адресе, как только он опускается ниже порога
POST
Создать правило для bandwidth
Создать правило для bandwidth
Создаёт правило автопополнения для одного адреса. Начиная со следующей проверки, всякий раз, когда доступного bandwidth на адресе меньшеthreshold_bandwidth, мы покупаем add_volume bandwidth на выбранный срок duration и списываем стоимость с вашего баланса. Как устроены проверки, стоимость и статусы, — в обзоре.
Запрос только создаёт правило — сам он ничего не покупает. Нужен скоуп buy_bandwidth. Чтобы сначала узнать цену одного пополнения, см. Рассчитать цену пополнения bandwidth.
Доступный bandwidth учитывает всё, чем адрес может оплатить транзакцию: бесплатные 600 в сутки плюс любой застейканный или делегированный bandwidth. Порог 600 или ниже выполняется за счёт одного лишь бесплатного лимита, пока адрес его не израсходует.
Тело запроса
string
обязательно
Адрес TRON, который нужно держать обеспеченным (формат T…, 34 символа). Адреса контрактов отклоняются.
number
обязательно
Покупать, когда доступного bandwidth на адресе меньше этого значения. От 1 до 1 000 000.
number
обязательно
Сколько bandwidth покупать за одно пополнение. От 350 до 100 000. Держите значение не ниже
threshold_bandwidth — см. предупреждение в обзоре.string
по умолчанию:"1h"
Срок аренды для каждого пополнения:
"1h" или "1d".string
Ваше собственное название правила, до 100 символов. Необязательно.
Ответ
Новое правило — с теми же полями, что в Списке правил для bandwidth, — плюс два поля о текущем состоянии адреса:number | null
Bandwidth, доступный на адресе в момент создания правила, включая бесплатный.
null, если его не удалось прочитать; правило создаётся в любом случае.boolean
true, если current_bandwidth уже ниже порога, и значит следующая проверка — обычно в течение минуты — сделает покупку. false, если bandwidth на адресе достаточно или уровень не удалось прочитать.Пример
Response
Ошибки
detail — массив: