Obtener un evento

GET /v1/events/{event_id} · permiso events:read

Devuelve un evento en el mismo formato, con el mismo id, que entregan los webhooks (carga reducida). El id también es el encabezado webhook-id de la entrega, por lo que puede obtener el evento que anunció un webhook.

Solicitud

Parámetro En Obligatorio Descripción
event_id path sí Id del evento, con el prefijo evt_.

Respuesta

200 OK y el evento, en el mismo formato que un elemento de Listar eventos.

curl -sS https://api.keenauth.com/v1/events/evt_01j9xk3m7q8r2s4t6v8w0y2z4a \
  -H "Authorization: Bearer $KEENAUTH_API_KEY"

Errores

Cada error es un cuerpo application/problem+json con un code estable.

HTTP code Cuándo
401 unauthenticated La clave de API falta, no es válida o fue revocada.
403 insufficient_permissions La clave no tiene events:read.
404 not_found El evento no existe, pertenece a otro entorno, tiene más de 30 días o el id tiene un formato incorrecto.
429 rate_limited Se superó el límite de solicitudes; respete Retry-After.
503 service_unavailable Una dependencia no está disponible temporalmente; reintente más tarde.

Datos personales

Este endpoint contiene datos personales: eventos. Datos personales en las API de KeenAuth describe qué se almacena, durante cuánto tiempo se conserva y cómo se elimina. No envíe categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.