Önerilen kuruluşa katılın
POST /fapi/v1/me/organization-suggestions/{domain_id}:join · environment'ın giriş ana bilgisayarından çağrılır
Kuruluş önerilerimi listele bölümündeki bir öneriyi kabul eder: kimliği doğrulanmış kullanıcı, önerilen kuruluşun bir üyesi olur ve environment'ın varsayılan üye rolünü alır. Üyeliğin kaynağı domain_capture olur ve kullanıcı işlemi yapan olarak kaydedilir; bir organization_membership.created olayı gönderilir. Aynı anda yapılan iki katılımdan yalnızca biri başarılı olur. Katılım için yakın zamanda doğrulanmış bir oturum gerekmez: yalnızca varsayılan üye rolünü verir ve yalnızca kullanıcının e-posta adresini doğruladığı bir alan adı için geçerlidir. Kimliği doğrulanmış kullanıcının __Host-idp_session çerezi gereklidir; çerez yoksa, süresi dolmuşsa veya iptal edilmişse 401 unauthenticated döndürür. Farklı bir kökenden gelen birinci taraf uygulama, bunun yerine ön yüz API erişim belirtecini gönderebilir (DPoP kanıtıyla birlikte Authorization: DPoP <token>; bkz. Ön yüz API erişim belirteci).
@keenauth/js ile: await keenauth.organizations.joinSuggestion(id).
İstek
Üstbilgiler:
| Üstbilgi | Zorunlu | Açıklama |
|---|---|---|
Idp-Client |
evet | SDK tanımlayıcısı. |
Origin |
evet | Tam olarak https://<giriş ana bilgisayarı> olmalıdır. |
domain_id: önerinin id değeri (odm_…).
Gövde yoktur (boş bir JSON nesnesi kabul edilir).
Yanıt
{"membership_id": "mem_…", "organization_id": "org_…"} içeren 200 OK.
Hatalar
| Durum | Kod | Ne zaman |
|---|---|---|
| 401 | unauthenticated |
Geçerli bir oturum çerezi veya ön yüz API erişim belirteci yoksa. |
| 403 | origin_not_allowed |
Origin eksikse veya yanlışsa. |
| 403 | role_not_assignable |
Varsayılan üye rolü alan adı yakalamasıyla verilemiyorsa. |
| 403 | user_not_active |
Kullanıcı etkin değilse. |
| 404 | not_found |
Alan adı bu kullanıcı için bir öneri değilse (bilinmiyorsa, hatalı biçimdeyse, suggest modunda değilse, içinde doğrulanmış bir adres yoksa veya üç kez kapatılmışsa). |
| 409 | membership_already_exists |
Kullanıcının bu kuruluşta zaten bir üyeliği varsa. |
| 409 | organization_disabled |
Kuruluş devre dışıysa veya silinmekteyse. |
| 409 | membership_limit_reached |
Kullanıcı üyelik sınırına ulaştıysa. |
| 409 | organization_membership_limit_reached |
Kuruluş üyelik sınırına ulaştıysa. |
| 503 | temporarily_unavailable |
Üyelik dizini yanıt vermediyse; daha sonra yeniden deneyin. |
Örnek
curl -X POST https://example.keenauth.app/fapi/v1/me/organization-suggestions/odm_01j9a5c4000000000000000001:join \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt
{
"membership_id": "mem_01j9yyyyyyyyyyyyyyyyyyyyyy",
"organization_id": "org_01j9xxxxxxxxxxxxxxxxxxxxxx"
}
Kişisel veriler
Bu uç nokta kişisel veri içerir: kuruluş üyelikleri ve davetler. KeenAuth API'lerinde kişisel veriler neyin saklandığını, ne kadar süre tutulduğunu ve nasıl silindiğini açıklar. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.