イベントを取得する
GET /v1/events/{event_id} · 権限 events:read
Webhook が配信するものと同じ形式、同じ id で 1 件のイベントを返します（シンペイロード）。この id は配信時の webhook-id ヘッダーにもなっているため、Webhook が通知したイベントを取得できます。
リクエスト
| パラメーター | 場所 | 必須 | 説明 |
|---|---|---|---|
event_id |
パス | はい | イベント ID。evt_ で始まります。 |
レスポンス
200 OK とイベントを返します。形式は イベントの一覧取得 の項目と同じです。
curl -sS https://api.keenauth.com/v1/events/evt_01j9xk3m7q8r2s4t6v8w0y2z4a \
-H "Authorization: Bearer $KEENAUTH_API_KEY"
エラー
すべてのエラーは、安定した code を含む application/problem+json の本文で返されます。
| HTTP | code |
発生条件 |
|---|---|---|
| 401 | unauthenticated |
API キーがない、無効である、または取り消されています。 |
| 403 | insufficient_permissions |
キーに events:read がありません。 |
| 404 | not_found |
イベントが存在しない、別の環境に属している、30 日より古い、または ID の形式が不正です。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After に従ってください。 |
| 503 | service_unavailable |
依存先が一時的に利用できません。後ほど再試行してください。 |
個人データ
このエンドポイントはイベントという個人データを扱います。KeenAuth API における個人データでは、保存される内容、保存期間、削除方法を説明しています。いかなるフィールドにも、特別な種類の個人データ（健康、生体情報、宗教、政治的意見、性的指向）を送信しないでください。