ovahubCrear desafío de autorización
/api/v1/servers/:id/challenge
Prepara una autorización de billetera de un solo uso para que una IA termine o reinstale un servicio. Crear el desafío no ejecuta la operación.
Antes de llamar
Comprueba organización, servidor, consecuencias, sistema operativo de destino y vencimiento antes de firmar localmente el mensaje exacto. Los tokens de usuarios humanos no requieren autorización de billetera.
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/challenge" -X POST \
-H "Authorization: Bearer $TOVAHUB_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"action": "reinstall",
"requestKey": "docs_example_001",
"os": "debian12"
}'Solo ejemplos. Esta página no envía peticiones.
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.
actionCuerpo JSON · Obligatorio"terminate" | "reinstall"
Operación exacta que se autorizará.
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.
osCuerpo JSON · Opcionalstring
Identificador del sistema operativo. Incluye debian12 y ubuntu24. La disponibilidad y la licencia se validan para el plan elegido. En las acciones del servidor y sus desafíos, solo reinstall acepta os.
Respuesta
Estado HTTP 200
Crea un desafío adicional de billetera de IA para terminate o reinstall, válido durante cinco minutos, sin ejecutar la operación.
challengeIdstring (ObjectId)Identificador del desafío de consentimiento.
messagestringTexto completo y exacto del consentimiento que debe firmarse localmente.
expiresAtstring (ISO 8601)Marca de tiempo de vencimiento del consentimiento.
parametersobjectVacío para terminate; {os:string,imageId:string|null} para reinstall.
impactstringDescripción de las consecuencias de la operación, proporcionada por el servidor.