Перейти к основному содержанию
POST
Создать правило для энергии

Создать правило для энергии

Создаёт правило автопополнения для одного адреса. Начиная со следующей проверки, всякий раз, когда доступной энергии на адресе меньше threshold_energy, мы покупаем add_volume энергии на один час и списываем стоимость с вашего баланса. Как устроены проверки, стоимость и статусы, — в обзоре. Запрос только создаёт правило — сам он ничего не покупает. Нужен скоуп buy_energy. Чтобы сначала узнать цену одного пополнения, см. Рассчитать цену пополнения энергии.

Тело запроса

string
обязательно
Адрес TRON, который нужно держать обеспеченным (формат T…, 34 символа). Адреса контрактов отклоняются.
number
обязательно
Покупать, когда доступной энергии на адресе меньше этого значения. От 1 до 50 000 000.
number
обязательно
Сколько энергии покупать за одно пополнение. От 32 000 до 5 000 000. Держите значение не ниже threshold_energy — см. предупреждение в обзоре.
string
по умолчанию:"1h"
Срок аренды для каждого пополнения. Принимается только "1h"; любое другое значение вернёт 422.
string
Ваше собственное название правила, до 100 символов. Необязательно.

Ответ

Новое правило — с теми же полями, что в Списке правил для энергии, — плюс два поля о текущем состоянии адреса:
number | null
Энергия, доступная на адресе в момент создания правила. null, если её не удалось прочитать; правило создаётся в любом случае.
boolean
true, если current_energy уже ниже порога, и значит следующая проверка — обычно в течение минуты — сделает покупку. false, если на адресе достаточно энергии или уровень не удалось прочитать.

Пример

Response

Ошибки

Ошибка валидации приходит в формате фреймворка, где detail — массив:
Повторять создание после таймаута безопасно. Если первый запрос прошёл, повтор вернёт 409 AUTOREFILL_ADDRESS_TAKEN, а не создаст второе правило; чтобы узнать его id, запросите список правил.