Ir a la documentación
DocumentaciónReferencia de la APILeer creación de cortafuegos del equipo
GETToken Bearer

Leer creación de cortafuegos del equipo

/api/v1/firewall-requests/:requestKey

Lee un registro de creación enviado por el equipo actual fijo, con su autor original.

Antes de llamar

Solo lee registros: no envía, reintenta, desbloquea ni llama al proveedor. La ausencia de registro no prueba que no se creara nada. Un éxito histórico no confirma la protección actual. Se mantiene la auditoría de autenticación.

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/firewall-requests/undefined" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

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

Respuesta ilustrativa
JSON
{
  "requestKey": "original_create_1",
  "actorUserId": "507f1f77bcf86cd799439013",
  "name": "Office",
  "state": "pending",
  "createdAt": "2026-11-01T00:00:00.000Z",
  "updatedAt": "2026-11-01T00:00:00.000Z",
  "resource": null
}

Parámetros

requestKeyRuta · Obligatorio

string

requestKey de la creación original. La recuperación no genera otra clave.

Respuesta

Estado HTTP 200

Solo un registro guardado; no verifica al proveedor ni reintenta la operación.

requestKeystring | null

Clave original, o null en registros antiguos incompletos.

namestring | null

Nombre guardado o null. No devuelve reglas ni datos originales del proveedor.

statestring

Estado guardado: new, started, pending, succeeded, failed o unknown. Ninguno autoriza reenviar.

createdAtstring | null

Fecha ISO guardada, o null si no está disponible. La lectura no la actualiza.

updatedAtstring | null

Fecha ISO guardada, o null si no está disponible. La lectura no la actualiza.

resource{ id: string, state: string } | null

Recurso local de la misma organización {id, state}, o null. No recrea recursos eliminados o ausentes.

actorUserIdstring (ObjectId) | null

ID de la cuenta del autor original, o null si falta en el historial. El lector debe ser miembro activo del mismo equipo fijo.