Obtenir un événement
GET /v1/events/{event_id} · autorisation events:read
Renvoie un événement dans la même structure, avec le même id, que celle transmise par les webhooks (charge utile allégée). L'id correspond aussi à l'en-tête webhook-id de la livraison, ce qui permet de récupérer l'événement annoncé par un webhook.
Requête
| Paramètre | Emplacement | Obligatoire | Description |
|---|---|---|---|
event_id |
path | oui | Identifiant de l'événement, préfixé par evt_. |
Réponse
200 OK et l'événement, dans la même structure qu'un élément de Lister les événements.
curl -sS https://api.keenauth.com/v1/events/evt_01j9xk3m7q8r2s4t6v8w0y2z4a \
-H "Authorization: Bearer $KEENAUTH_API_KEY"
Erreurs
Chaque erreur est un corps application/problem+json accompagné d'un code stable.
| HTTP | code |
Quand |
|---|---|---|
| 401 | unauthenticated |
La clé d'API est absente, invalide ou révoquée. |
| 403 | insufficient_permissions |
La clé ne possède pas events:read. |
| 404 | not_found |
L'événement n'existe pas, appartient à un autre environnement, a plus de 30 jours, ou l'identifiant est mal formé. |
| 429 | rate_limited |
La limite de débit a été dépassée ; respectez Retry-After. |
| 503 | service_unavailable |
Une dépendance est temporairement indisponible ; réessayez plus tard. |
Données personnelles
Cet endpoint traite des données personnelles : les événements. Données personnelles dans les API KeenAuth décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. N'envoyez de données sensibles au sens du RGPD (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.