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 "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
{
"ok": true,
"enabled": true,
"supplierRenewalReady": false
}Parámetros
idRuta · Obligatoriostring
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 · Obligatorioboolean
Nuevo estado de habilitación.
requestKeyCuerpo JSON · Obligatoriostring
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.
enabledbooleanValor 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.