GET
/
v1
/
alerts
/
{id}
curl --request GET \
  --url https://api.casebender.com/v1/alerts/{id}

​
Descripción

Este endpoint devuelve información detallada sobre una alerta específica identificada por su ID único. La respuesta incluye todos los detalles de la alerta, incluyendo severidad, estado, campos personalizados y observables asociados.

​
Parámetros de Ruta

​
id
string
required

El identificador único de la alerta

​
Respuesta

​
status
string

Estado de la respuesta (success o error)

​
data
object

Objeto con los detalles de la alerta

​
data.id
string

Identificador único de la alerta

​
data.title
string

Título de la alerta

​
data.description
string

Descripción detallada de la alerta

​
data.severity
string

Nivel de severidad (low, medium, high, critical)

​
data.status
string

Estado actual de la alerta

​
data.source
string

Fuente de la alerta

​
data.created_at
string

Fecha y hora de creación

​
data.updated_at
string

Fecha y hora de última actualización

​
data.assigned_to
string | null

Usuario asignado a la alerta (o null si no está asignada)

​
data.tags
array

Lista de etiquetas asociadas a la alerta

​
data.observables
array

Lista de observables asociados a la alerta

​
data.custom_fields
object

Campos personalizados definidos para la alerta

​
Ejemplo de Solicitud

curl -X GET "https://api.casebender.com/v1/alerts/alert-123" \
  -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": "ana.garcia@empresa.com",
    "tags": ["suspicious", "login"],
    "observables": [
      {
        "type": "ip",
        "value": "192.168.1.1"
      },
      {
        "type": "user",
        "value": "john.doe@example.com"
      }
    ],
    "custom_fields": {
      "impacto_estimado": "Medio",
      "sistema_afectado": "Sistema de Autenticación",
      "requiere_escalamiento": false
    }
  }
}

​
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 404 -
Not Found - Alerta no encontrada 500 - Internal Server Error - Error del
servidor

​
Notas