Kuruluş önerisini kapatın
POST /fapi/v1/me/organization-suggestions/{domain_id}:dismiss · environment'ın giriş ana bilgisayarından çağrılır
Kuruluş önerilerimi listele bölümündeki bir öneriyi kapatır. Sayaç kuruluş bazında tutulur: birden fazla önerilen alan adına sahip bir kuruluş tek bir öneri sayılır. Üçüncü kapatmadan sonra kuruluş artık önerilmez (hidden değeri true olur) ve sonraki kapatmalar veya katılımlar 404 not_found döndürür. Aynı anda yapılan iki kapatma da sayılır. 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.dismissSuggestion(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
{"dismiss_count": 1, "hidden": false} içeren 200 OK. dismiss_count değeri 1 ile 3 arasındadır.
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. |
| 404 | not_found |
Alan adı bu kullanıcı için bir öneri değilse veya üç kez zaten kapatılmışsa. |
| 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:dismiss \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt
{
"dismiss_count": 1,
"hidden": false
}
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.