GET
/
v1
/
alerts
Obtener Alertas
curl --request GET \
  --url https://api.casebender.com/v1/alerts

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

page
integer
default:"1"

Número de página para la paginación

limit
integer
default:"20"

Número de resultados por página (máximo 100)

status
string

Filtrar por estado de alerta (open, closed, in_progress)

severity
string

Filtrar por severidad (low, medium, high, critical)

from_date
string

Filtrar alertas creadas después de esta fecha (formato ISO 8601)

to_date
string

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

status
string

Estado de la respuesta (success o error)

data
array

Lista de objetos de alerta

pagination
object

Información de paginación

pagination.total
integer

Número total de alertas que coinciden con los criterios de filtro

pagination.pages
integer

Número total de páginas

pagination.current_page
integer

Página actual

pagination.limit
integer

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