Saltar para o conteúdo principal
PATCH
Atualizar assinatura

Atualizar assinatura

Altera as configurações de uma assinatura, pausa-a ou retoma-a, ou a move para outro endereço. Envie apenas os campos que quiser alterar; os demais ficam como estão. As alterações valem na hora: verificamos a assinatura de novo após cada edição. Exige o escopo buy_bandwidth.

Parâmetros de caminho

number
obrigatório
ID da assinatura — o id de Criar ou Listar assinaturas

Corpo da requisição

boolean
false pausa a assinatura: retiramos a largura de banda e não cobramos nada até você retomá-la. true retoma uma assinatura pausada ou parada; o seu saldo deve cobrir 24 horas e uma transferência, como ao criar. Uma assinatura desligada pelo suporte (stopped_reason: "admin") não pode ser retomada assim.
number
Nova quantidade de largura de banda. De 1 a 5.000. Aumentá-la dentro de um dia pago cobra a diferença pelo restante do dia.
string
Mover a assinatura para outro endereço. Retiramos a largura de banda do endereço antigo e depois delegamos ao novo; address_change_to mostra a mudança até ela terminar. O novo endereço passa pelas mesmas verificações da criação. Enviar o endereço atual cancela uma mudança que não terminou.
string
"USDT", "TRX", "USDD", "CUSTOM" ou "OWN". Mudar para USDT, TRX ou USDD remove o contract.
string | null
Um contrato da sua lista de tokens, para CUSTOM ou OWN. null o remove (não é possível com CUSTOM).
string | null
Novo nome, até 50 caracteres. null ou uma string vazia o remove.
boolean
Liga ou desliga a pausa automática.
number
Novo nível de largura de banda gratuita, com o mesmo intervalo da criação.
boolean
Liga ou desliga a notificação de largura de banda gratuita.
boolean
true pausa a assinatura após a próxima transferência do seu token, contada a partir de agora. false cancela isso.

Resposta

A assinatura atualizada, com os mesmos campos de Listar assinaturas.

Exemplo

Pausar uma assinatura:
Response
delegated_bw cai para 0 assim que a largura de banda é retirada, em poucos segundos.

Erros