Kuruluş seç

POST /fapi/v1/authorization-requests/{authorization_request_id}:select-organization · ortamın oturum açma host'undan çağrılır

Kullanıcının barındırılan seçicide seçtiği kuruluşu yetkilendirme isteğine bağlar. Sunucu seçimi yeniden denetler. organization_id, çağrı anında bu kullanıcı ve uygulama için Seçilebilir kuruluşları listele listesinde olmalıdır.

Listede olmayan her değer 422 validation_failed alır ve hiçbir şey bağlanmaz. Örnekler:

Başka bir kullanıcının kuruluşu.
Başka bir ortamın kuruluşu.
Uygulamanın etkin olmadığı bir kuruluş.
Biçimsiz bir kimlik.

Kabul edilen kuruluş isteğe bir kez yazılır ve sonradan değişmez. Yanıt continue_url taşır; bu, yetkilendirme ucunun devam adresidir. Tarayıcı oraya gider ve yetkilendirme, kuruluş bağlı olarak sürer.

İstek koşulları ve 404 yanıtı liste ucundakiyle aynıdır. 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ı.
`Origin`	evet	Tam olarak `https://<oturum açma host'u>` olmalıdır.
`Content-Type`	evet	`application/json`.

Gövde:

Alan	Tür	Zorunlu	Açıklama
`organization_id`	string	evet	Listedeki bir kuruluşun `id` değeri (`org_…`).

Yanıt

200 OK:

Alan	Tür	Açıklama
`continue_url`	string	Tarayıcının devam edeceği adres: yetkilendirme ucunun devam adresi.

{"continue_url": "/oauth2/authorize/resume?authorization_request=azr_01jbz6x8kq3m2n4p5r6s7t8v9w"}

Hatalar

Durum	Kod	Ne zaman
400	`malformed_request`	Gövde geçerli JSON değil.
400	`unknown_field`	Gövdede `organization_id` dışında alan var.
401	`unauthenticated`	Geçerli oturum çerezi yok.
403	`origin_not_allowed`	`Origin` eksik ya da yanlış.
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ış.
413	`payload_too_large`	Gövde çok büyük.
415	`unsupported_media_type`	`Content-Type` `application/json` değil.
422	`validation_failed`	`organization_id` eksik ya da listedeki kuruluşlardan biri değil.
503	`temporarily_unavailable`	Kuruluş listesi okunamadı.

Örnek

curl -X POST https://example.keenauth.app/fapi/v1/authorization-requests/azr_01jbz6x8kq3m2n4p5r6s7t8v9w:select-organization \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{"organization_id": "org_01jbz6x8kq3m2n4p5r6s7t8v9w"}'