セッションを一覧表示
GET /fapi/v1/me/sessions · 環境のサインインホストから呼び出します
認証済みユーザーの有効なセッションを、最後にアクセスされた順(新しいものが先)で返します。リクエストを行っているセッションには current: true が設定されます。認証済みユーザーの __Host-idp_session Cookie が必要です。Cookie がない、期限切れである、または取り消されている場合は 401 unauthenticated を返します。別のオリジンにある自社アプリは、代わりにフロント API アクセストークン(DPoP 証明付きの Authorization: DPoP <token>。フロント API アクセストークンを参照)を送信できます。直近での再検証は不要です。
リクエスト
ヘッダー:
| ヘッダー | 必須 | 説明 |
|---|---|---|
Idp-Client |
はい | SDK の識別子です。 |
ボディはありません。
レスポンス
200 OK:
| フィールド | 型 | 説明 |
|---|---|---|
data[].id |
string | セッション識別子(ses_…)です。 |
data[].current |
boolean | リクエストを行っているセッションかどうかです。 |
data[].login_host |
string | セッションが開始されたサインインホストです。 |
data[].browser_family |
string | 判明している場合のブラウザファミリーです。 |
data[].os_family |
string | 判明している場合のオペレーティングシステムファミリーです。 |
data[].device_type |
string | 判明している場合のデバイスの種類です。 |
data[].country |
string | 判明している場合に、セッションが開始された国です(ISO 3166-1 alpha-2)。 |
data[].ip_address |
string | 最後に確認された IP アドレスです。ない場合はセッション開始時の IP アドレスです。保持期間を過ぎると存在しません。ユーザー本人にのみ表示されます。 |
data[].created_at |
string | セッションが開始された日時です(RFC 3339、UTC)。 |
data[].last_seen_at |
string | セッションが最後に使用された日時です(RFC 3339、UTC)。 |
{
"data": [
{
"id": "ses_01jbz6x8kq3m2n4p5r6s7t8v9w",
"current": true,
"login_host": "example.keenauth.app",
"browser_family": "firefox",
"os_family": "linux",
"device_type": "desktop",
"country": "DE",
"ip_address": "192.0.2.10",
"created_at": "2026-10-01T09:30:00Z",
"last_seen_at": "2026-10-12T08:15:00Z"
}
]
}
エラー
| ステータス | コード | 発生条件 |
|---|---|---|
| 401 | unauthenticated |
有効なセッション Cookie がありません。 |
例
curl https://example.keenauth.app/fapi/v1/me/sessions \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
個人データ
このエンドポイントは個人データ(セッション)を扱います。KeenAuth API における個人データでは、保存される内容、保存期間、削除方法を説明しています。どのフィールドにも特別な種類の個人データ(健康、生体データ、宗教、政治的意見、性的指向)を送信しないでください。