Saltar al contenido principal
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)
​
search
string
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
⌘I