Descripción
Este endpoint devuelve una lista paginada de alertas. Puede filtrar las alertas por varios criterios como severidad, estado, fecha, etc.
Parámetros de Consulta
Número de página para la paginación
Número de resultados por página (máximo 100)
Filtrar por estado de alerta (open, closed, in_progress)
Filtrar por severidad (low, medium, high, critical)
Filtrar alertas creadas después de esta fecha (formato ISO 8601)
Filtrar alertas creadas antes de esta fecha (formato ISO 8601)
Término de búsqueda para filtrar alertas por título o descripción
Respuesta
Estado de la respuesta (success o error)
Lista de objetos de alerta
Información de paginación
Número total de alertas que coinciden con los criterios de filtro
Número de resultados por página
Ejemplo de Solicitud
curl -X GET "https://api.casebender.com/v1/alerts?status=open&severity=high&limit=10" \
-H "Authorization: Bearer su-token-jwt"
Ejemplo de Respuesta
{
"status": "success",
"data": [
{
"id": "alert-123",
"title": "Actividad sospechosa detectada",
"description": "Se detectó un intento de inicio de sesión desde una ubicación inusual",
"severity": "high",
"status": "open",
"source": "auth_service",
"created_at": "2023-01-15T08:30:00Z",
"updated_at": "2023-01-15T08:30:00Z",
"assigned_to": null,
"tags": ["suspicious", "login"],
"observables": [
{
"type": "ip",
"value": "192.168.1.1"
},
{
"type": "user",
"value": "john.doe@example.com"
}
]
}
// ... más alertas
],
"pagination": {
"total": 45,
"pages": 5,
"current_page": 1,
"limit": 10
}
}
Códigos de Estado
200 - OK - La solicitud se completó con éxito 400 - Bad Request - Parámetros
de consulta inválidos 401 - Unauthorized - Token de autenticación faltante o
inválido 403 - Forbidden - No tiene permiso para acceder a este recurso 429 -
Too Many Requests - Se ha excedido el límite de tasa 500 - Internal Server
Error - Error del servidor
Notas
- Las alertas se ordenan por fecha de creación en orden descendente (las más recientes primero)
- Para obtener todos los detalles de una alerta específica, utilice el endpoint Obtener Alerta por ID
Responses are generated using AI and may contain mistakes.