ovahub
Ir a la documentación
DocumentaciónReferencia de la APIConsultar registros de operaciones
GETToken Bearer

Consultar registros de operaciones

/api/v1/audit

Consulta las operaciones enviadas de servidores, instantáneas, cortafuegos y redes privadas del equipo fijo, incluidos recursos retirados. Requiere permiso de auditoría; diez registros por página, sin credenciales ni estados de ejecución.

Antes de llamar

Solo consulta registros: no reintenta operaciones ni llama al proveedor. Excluye credenciales, firmas, datos originales y estados de ejecución; no es una exportación completa.

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/audit?type=all&action=shutdown&page=1" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

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

Respuesta ilustrativa
JSON
{
  "page": 1,
  "limit": 10,
  "total": 1,
  "events": [
    {
      "id": "server:507f1f77bcf86cd799439014",
      "type": "server",
      "action": "shutdown",
      "actor": {
        "id": "507f1f77bcf86cd799439012",
        "name": "Alex"
      },
      "resource": {
        "id": "507f1f77bcf86cd799439013",
        "name": "api-node"
      },
      "createdAt": "2026-11-12T04:00:00.000Z"
    }
  ]
}

Parámetros

typeConsulta · Opcional

string

all, server, firewall o network. Predeterminado: all.

actionConsulta · Opcional

string

Una acción exacta del esquema o all. Predeterminado: all; filtros incompatibles devuelven una página vacía.

pageConsulta · Opcional

integer

Página del 1 al 10000. Diez registros por página.

Respuesta

Estado HTTP 200

Operaciones seguras del equipo fijo autenticado, sin estados de tareas, credenciales ni datos del proveedor.

pageinteger

Página solicitada, a partir de 1.

limit10

Tamaño fijo de página.

totalinteger

Total de registros coincidentes en este equipo fijo.

eventsarray

Operaciones coincidentes más recientes, hasta diez.

events[].idstring

ID estable del registro con prefijo server, firewall o network.

events[].typestring

server, firewall o network.

events[].actionstring

Acción segura exacta definida en el esquema.

events[].actorobject

id y name; las identidades no disponibles usan null. No consulta identidades de otros equipos.

events[].resourceobject

ID de plataforma y nombre, o null si no están disponibles. Puede ser un recurso retirado.

events[].createdAtstring

Fecha ISO 8601 de aceptación de la operación.

Relacionado

Peticiones y erroresAutenticaciónMCP · list_audit_records