Перейти к основному содержанию
PATCH
Изменить подписку

Изменить подписку

Меняет настройки подписки, ставит её на паузу или возобновляет, либо переносит на другой адрес. Передавайте только те поля, которые хотите изменить; остальные остаются как есть. Изменения применяются сразу: после каждой правки мы заново проверяем подписку. Нужен скоуп buy_bandwidth.

Параметры пути

number
обязательно
ID подписки — id из создания подписки или списка подписок

Тело запроса

boolean
false ставит подписку на паузу: мы забираем bandwidth обратно и ничего не списываем, пока вы её не возобновите. true возобновляет приостановленную или остановленную подписку; баланса должно хватать на 24 часа и один перевод, как при создании. Подписку, выключенную поддержкой (stopped_reason: "admin"), так возобновить нельзя.
number
Новый объём bandwidth. От 1 до 5 000. Увеличение внутри оплаченных суток списывает разницу за остаток суток.
string
Перенести подписку на другой адрес. Мы забираем bandwidth со старого адреса, затем делегируем на новый; пока перенос не завершён, address_change_to его показывает. Новый адрес проходит те же проверки, что и при создании. Если передать текущий адрес, незавершённый перенос отменяется.
string
"USDT", "TRX", "USDD", "CUSTOM" или "OWN". Переключение на USDT, TRX или USDD убирает contract.
string | null
Контракт из вашего списка токенов для CUSTOM или OWN. null убирает его (с CUSTOM это невозможно).
string | null
Новое название, до 50 символов. null или пустая строка убирает его.
boolean
Включить или выключить авто-паузу.
number
Новый уровень бесплатного bandwidth с тем же диапазоном, что и при создании.
boolean
Включить или выключить уведомление о бесплатном bandwidth.
boolean
true ставит подписку на паузу после следующего перевода её токена, считая с этого момента. false отменяет это.

Ответ

Обновлённая подписка — с теми же полями, что в Списке подписок.

Пример

Приостановка подписки:
Response
delegated_bw падает до 0, как только bandwidth забран обратно, — в течение нескольких секунд.

Ошибки