Ein Ereignis abrufen
GET /v1/events/{event_id} · Berechtigung events:read
Gibt ein Ereignis in derselben Form zurück, mit derselben id, die Webhooks ausliefern (Thin Payload). Die id ist außerdem der Header webhook-id der Zustellung, sodass Sie das Ereignis abrufen können, das ein Webhook angekündigt hat.
Anfrage
| Parameter | In | Pflicht | Beschreibung |
|---|---|---|---|
event_id |
path | ja | Ereignis-ID, mit dem Präfix evt_. |
Antwort
200 OK und das Ereignis in derselben Form wie ein Eintrag unter Ereignisse auflisten.
curl -sS https://api.keenauth.com/v1/events/evt_01j9xk3m7q8r2s4t6v8w0y2z4a \
-H "Authorization: Bearer $KEENAUTH_API_KEY"
Fehler
Jeder Fehler ist ein Body vom Typ application/problem+json mit einem stabilen code.
| HTTP | code |
Wann |
|---|---|---|
| 401 | unauthenticated |
Der API-Schlüssel fehlt, ist ungültig oder widerrufen. |
| 403 | insufficient_permissions |
Der Schlüssel besitzt nicht events:read. |
| 404 | not_found |
Das Ereignis existiert nicht, gehört zu einer anderen Umgebung, ist älter als 30 Tage, oder die ID ist fehlerhaft. |
| 429 | rate_limited |
Das Ratenlimit wurde überschritten; beachten Sie Retry-After. |
| 503 | service_unavailable |
Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage später. |
Personenbezogene Daten
Dieser Endpunkt verarbeitet personenbezogene Daten: Ereignisse. Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).