Ir a la documentación
DocumentaciónReferencia de la APIConfigurar preferencia de renovación
POSTToken Bearer

Configurar preferencia de renovación

/api/v1/servers/:id/autorenew

Guarda la preferencia de renovación automática del sitio.

Antes de llamar

No renueva ni cancela el contrato del proveedor. La integración de renovación con el proveedor actual no está disponible.

Los nombres de campos, los tipos y el código de la API se mantienen iguales en todos los idiomas.

Ejemplo de petición

cURL
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012/autorenew" -X POST \
  -H "Authorization: Bearer $TOVAHUB_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "enabled": true,
  "requestKey": "docs_example_001"
}'

Solo ejemplos. Esta página no envía peticiones.

Respuesta ilustrativa
JSON
{
  "ok": true,
  "enabled": true,
  "supplierRenewalReady": false
}

Parámetros

idRuta · Obligatorio

string

ID del recurso: 24 caracteres hexadecimales. Use el ID de la plataforma devuelto por el endpoint de listado correspondiente, no el ID de instancia del proveedor.

enabledCuerpo JSON · Obligatorio

boolean

Nuevo estado de habilitación.

requestKeyCuerpo JSON · Obligatorio

string

Entre 8 y 100 caracteres: A–Z, a–z, 0–9, guion bajo o guion. Al reintentar la misma operación, conserve la clave y todos los datos de entrada.

Respuesta

Estado HTTP 200

Guarda la preferencia de renovación automática del sitio sin renovar un contrato del proveedor.

okboolean (true)

Se guardó la preferencia o se devolvió el resultado original.

enabledboolean

Valor original guardado de la preferencia.

replayboolean (true, optional)

Solo aparece al repetir la misma solicitud.

supplierRenewalReadyboolean (false)

La integración actual de renovación con el proveedor no está disponible.