Bir olayı alın
GET /v1/events/{event_id} · izin events:read
Webhook'ların ilettiği olayla aynı biçimde, aynı id ile tek bir olay döner (ince yük). Bu id aynı zamanda teslimatın webhook-id başlığıdır; böylece bir webhook'un duyurduğu olayı alabilirsiniz.
İstek
| Parametre | Konum | Zorunlu | Açıklama |
|---|---|---|---|
event_id |
path | evet | evt_ ön ekli olay kimliği. |
Yanıt
200 OK ve olay, Olayları listeleyin öğesindeki kayıtla aynı biçimde.
curl -sS https://api.keenauth.com/v1/events/evt_01j9xk3m7q8r2s4t6v8w0y2z4a \
-H "Authorization: Bearer $KEENAUTH_API_KEY"
Hatalar
Her hata, kararlı bir code içeren bir application/problem+json gövdesidir.
| HTTP | code |
Ne zaman |
|---|---|---|
| 401 | unauthenticated |
API anahtarı eksik, geçersiz veya iptal edilmiş. |
| 403 | insufficient_permissions |
Anahtarın events:read izni yok. |
| 404 | not_found |
Olay yok, başka bir ortama ait, 30 günden eski veya kimlik biçimi hatalı. |
| 429 | rate_limited |
Hız sınırı aşıldı; Retry-After değerine uyun. |
| 503 | service_unavailable |
Bir bağımlılık geçici olarak kullanılamıyor; daha sonra yeniden deneyin. |
Kişisel veriler
Bu uç nokta kişisel veri içerir: olaylar. KeenAuth API'lerinde kişisel veriler neyin saklandığını, ne kadar süreyle tutulduğunu ve nasıl silindiğini açıklar. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.