Seçilebilir kuruluşları listele

GET /fapi/v1/authorization-requests/{authorization_request_id}/organizations · ortamın oturum açma host'undan çağrılır

/u/organization adresindeki barındırılan kuruluş seçicisi bu ucu çağırır. Bir uygulamanın organization_usage değeri require olabilir ve yetkilendirme isteği organization belirtmeyebilir. Bu durumda yetkilendirme ucu, kullanıcı giriş yaptıktan sonra kullanıcının kuruluşlarına bakar:

Kuruluş yoksa istek access_denied ve error_description=no_organization_membership ile biter.
Tek kuruluş varsa ekran gösterilmeden o kuruluş bağlanır.
İki ya da daha fazla kuruluş varsa tarayıcı seçiciye gider ve seçici bu listeyi okur.

Listede şu koşulların hepsini sağlayan kuruluşlar bulunur:

Kullanıcının kuruluşta etkin üyeliği vardır.
Kuruluş etkindir.
Uygulama kuruluşta etkindir.

Liste slug sırasındadır ve en çok 100 kayıt taşır. truncated: true daha fazlasının olduğunu gösterir. Bu oturumda son seçilen kuruluş listenin başındadır ve last_used: true taşır.

name müşteri verisidir ve denetim ile yön karakterleri ayıklanmış olarak döner. Adı olmayan kuruluşun name değeri slug'ıdır. Listeyi okumak hiçbir şey bağlamaz.

Yetkilendirme isteği şu koşulları sağlamalıdır:

Bekliyor durumdadır.
Bu oturum açma host'unda açılmıştır.
Yetkilendirme ucunun bu tarayıcıya yazdığı bağlama çerezini taşır.

Aşağıdaki isteklerin hepsi aynı 404 not_found yanıtını alır:

Biçimsiz ya da bilinmeyen istek.
Süresi dolmuş ya da tamamlanmış istek.
Başka host'ta açılmış istek.
Başka tarayıcıda açılmış istek.

Oturum açmış kullanıcının __Host-idp_session çerezi gerekir. Çerez yoksa, süresi dolmuşsa ya da iptal edilmişse yanıt 401 unauthenticated olur.

İstek

Yol parametresi:

Parametre	Açıklama
`authorization_request_id`	Seçici adresindeki `authorization_request` değeri (`azr_…`).

Başlıklar:

Başlık	Zorunlu	Açıklama
`Idp-Client`	evet	SDK tanımlayıcısı.

Gövde yok.

Yanıt

200 OK:

Alan	Tür	Açıklama
`data[].id`	string	Kuruluş kimliği (`org_…`).
`data[].slug`	string	Kuruluşun slug'ı.
`data[].name`	string	Görünen ad, düz metin.
`data[].last_used`	boolean	Bu oturumda son seçilen kuruluş olup olmadığı.
`truncated`	boolean	Kullanıcının listelenenden fazla uygun kuruluşu olup olmadığı.

{
  "data": [
    {"id": "org_01jbz6x8kq3m2n4p5r6s7t8v9w", "slug": "acme", "name": "Acme", "last_used": false},
    {"id": "org_01jbz6x8kq3m2n4p5r6s7t8v9x", "slug": "globex", "name": "Globex", "last_used": false}
  ],
  "truncated": false
}

Hatalar

Durum	Kod	Ne zaman
401	`unauthenticated`	Geçerli oturum çerezi yok.
404	`not_found`	İstek biçimsiz, bilinmiyor, süresi dolmuş, tamamlanmış, başka host'un ya da başka tarayıcının.
409	`conflict`	İsteğe zaten bir kuruluş bağlanmış.
503	`temporarily_unavailable`	Kuruluş listesi okunamadı.

Örnek

curl https://example.keenauth.app/fapi/v1/authorization-requests/azr_01jbz6x8kq3m2n4p5r6s7t8v9w/organizations \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt