Consultar eventos del servidor
/api/v1/servers/:id/events
Consulta las acciones del servidor registradas en la plataforma, en páginas de 10 entradas.
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/events?page=1" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"Solo ejemplos. Esta página no envía peticiones.
Respuesta ilustrativa
{
"page": 1,
"hasNext": false,
"events": []
}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.
pageConsulta · Opcionalinteger
El valor de consulta se interpreta como entero: de 1 a 1.000.000, con 1 como valor predeterminado. Use hasNext para continuar.
Respuesta
Estado HTTP 200
Consulta las acciones del servidor registradas en la plataforma y su estado observado, con paginación.
pagenumberPágina solicitada; el valor predeterminado es uno.
hasNextbooleanIndica si hay otra página.
eventsarrayEsta API devuelve hasta diez registros, ya que la ruta proporciona una página predeterminada.
events[].idstring (ObjectId)Identificador del evento de acción en la plataforma.
events[].actionstringAcción registrada; los eventos de renovación automática se denominan autorenew_on o autorenew_off.
events[].statusstringEstado observado; las tareas activas se muestran como pending.
events[].errornullEste listado devuelve actualmente null, en lugar de los detalles del error del evento.
events[].createdAtstring (ISO 8601)Fecha y hora de creación del evento.
events[].actorUserIdstring (ObjectId) | nullID de la cuenta del autor original, o null si falta en el historial. El lector debe ser miembro activo del mismo equipo fijo.
events[].taskKeystring | nullClave original de la tarea enviada para consultar get_server_task en modo lectura, o null. No reenvía, desbloquea ni concede permisos del autor original.