自分の組織の提案を一覧表示

GET /fapi/v1/me/organization-suggestions · サインインホストから呼び出されます

認証済みユーザーの確認済みメールアドレスのドメインに基づき、そのユーザーが参加を招待されている組織を一覧表示します。組織は、有効であり、そのドメインをドメインキャプチャsuggestに設定して確認済みであり、かつユーザーがそのメンバーではない場合に提案されます（削除済みまたは脱退済みのメンバーシップも対象に含まれるため、再度提案されることはありません）。組織は 1 件につき 1 項目が、スラッグ順に最大 20 件返されます。ユーザーが 3 回却下した組織は一覧に表示されません。環境のデフォルトのメンバーロールがドメインキャプチャで付与できないもの（管理者ロール、特権ロール、組織とそのメンバーの読み取りを超えるシステム権限を持つロール）の場合、一覧は空になります。読み取り操作は何も変更せず、最近確認されたセッションも必要ありません。認証済みユーザーの __Host-idp_session Cookie が必要です。Cookie がない、期限切れ、または取り消されている場合は 401 unauthenticated を返します。別のオリジンにある自社のファーストパーティアプリは、代わりにフロント API アクセストークン（DPoP 証明付きの Authorization: DPoP <token>）を送信できます。フロント API アクセストークン を参照してください。

@keenauth/js を指定すると: await keenauth.organizations.suggestions()。

リクエスト

ヘッダー:

クエリパラメータはありません。リクエストボディもありません。

レスポンス

200 OK と {"data": [...]} を返します。レスポンスはキャッシュされません（Cache-Control: no-store）。

各項目: id（odm_…、確認済みドメインのレコード。参加または却下に使用します）、domain（一致したメールアドレスのドメイン）、および organization と id（org_…）、slug と name（制御文字と双方向文字を除いた表示名。組織に名前がない場合はスラッグ。プレーンテキストとして表示してください）。

エラー

例

curl https://example.keenauth.app/fapi/v1/me/organization-suggestions \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt

{
  "data": [
    {
      "id": "odm_01j9a5c4000000000000000001",
      "domain": "acme.example",
      "organization": {
        "id": "org_01j9xxxxxxxxxxxxxxxxxxxxxx",
        "slug": "acme",
        "name": "Acme"
      }
    }
  ]
}

個人データ

このエンドポイントは個人データを扱います: 組織のメンバーシップと招待。KeenAuth API における個人データでは、保存される内容、保存期間、削除方法を説明しています。いかなるフィールドにも、特別な種類の個人データ（健康、生体情報、宗教、政治的意見、性的指向）を送信しないでください。