Saltar al contenido principal
PATCH
Actualizar suscripción

Actualizar suscripción

Cambia los ajustes de una suscripción, la pausa o la reanuda, o la mueve a otra dirección. Envía solo los campos que quieras cambiar; los demás se quedan como están. Los cambios se aplican de inmediato: volvemos a comprobar la suscripción después de cada edición. Requiere el alcance buy_bandwidth.

Parámetros de ruta

number
requerido
ID de la suscripción — el id de Crear o Listar suscripciones

Cuerpo de la solicitud

boolean
false pausa la suscripción: recuperamos el ancho de banda y no cobramos nada hasta que la reanudes. true reanuda una suscripción pausada o detenida; tu saldo debe cubrir 24 horas y una transferencia, igual que al crearla. Una suscripción desactivada por soporte (stopped_reason: "admin") no se puede reanudar de esta forma.
number
Nueva cantidad de ancho de banda. De 1 a 5,000. Subirla dentro de un día ya pagado cobra la diferencia por el resto del día.
string
Mueve la suscripción a otra dirección. Recuperamos el ancho de banda de la dirección anterior y luego delegamos a la nueva; address_change_to muestra el cambio hasta que termina. La nueva dirección pasa por las mismas comprobaciones que al crear. Enviar la dirección actual cancela un cambio que no ha terminado.
string
"USDT", "TRX", "USDD", "CUSTOM" u "OWN". Cambiar a USDT, TRX o USDD elimina el contract.
string | null
Un contrato de tu lista de tokens, para CUSTOM u OWN. null lo elimina (no es posible con CUSTOM).
string | null
Nueva etiqueta, hasta 50 caracteres. null o una cadena vacía la elimina.
boolean
Activa o desactiva la pausa automática.
number
Nuevo nivel de ancho de banda gratuito, con el mismo rango que al crear.
boolean
Activa o desactiva la notificación de ancho de banda gratuito.
boolean
true pausa la suscripción después de la siguiente transferencia de su token, contada desde ahora. false lo cancela.

Respuesta

La suscripción actualizada, con los mismos campos que en Listar suscripciones.

Ejemplo

Pausar una suscripción:
Response
delegated_bw baja a 0 cuando el ancho de banda se ha recuperado, en unos pocos segundos.

Errores