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.