自分の認証手段を一覧表示
GET /fapi/v1/me/authenticators · サインインホストから呼び出し
認証済みユーザーが登録している認証手段を一覧表示します。ユーザーの __Host-idp_session Cookie が必要です。Cookie が存在しない、期限切れである、または取り消されている場合は、401 unauthenticated を返します。別オリジンのファーストパーティアプリは、代わりにフロント API アクセストークン(DPoP 証明を付けた Authorization: DPoP <token>。フロント API アクセストークン を参照)を送信できます。
リクエスト
ヘッダー:
| ヘッダー | 必須 | 説明 |
|---|---|---|
Idp-Client |
はい | SDK の識別子です。 |
リクエストボディはありません。
レスポンス
200 OK で {"data": [...]} を返します。
各項目: id(cred_…)、type(passkey、security_key、totp、sms、email、push)、label、status(active または clone_suspected。署名カウンタが後退したことを示し、確認されるまで使用できません)、synced(同期済みパスキーかどうか)、created_at、last_used_at(一度も使用されていない場合は null)、last_used_country(存在する場合)。
エラー
| ステータス | コード | 発生条件 |
|---|---|---|
| 401 | unauthenticated |
有効なセッション Cookie がありません。 |
例
curl https://example.keenauth.app/fapi/v1/me/authenticators \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
個人データ
このエンドポイントは個人データ(認証情報)を扱います。KeenAuth API における個人データ では、保存される内容、保存期間、削除方法を説明しています。いかなるフィールドにも、特別な種類の個人データ(健康、生体データ、宗教、政治的意見、性的指向)を送信しないでください。