Organisationsvorschlag ablehnen
POST /fapi/v1/me/organization-suggestions/{domain_id}:dismiss · wird vom Anmelde-Host der Umgebung aufgerufen
Lehnt einen Vorschlag aus Meine Organisationsvorschläge auflisten ab. Die Anzahl wird pro Organisation erfasst: Eine Organisation mit mehreren vorgeschlagenen Domains ergibt einen Vorschlag. Nach der dritten Ablehnung wird die Organisation nicht mehr vorgeschlagen (hidden ist true), und weitere Ablehnungen oder Beitritte liefern 404 not_found. Zwei gleichzeitige Ablehnungen zählen beide. Erforderlich ist das Cookie __Host-idp_session des authentifizierten Benutzers; fehlt das Cookie, ist es abgelaufen oder widerrufen, wird 401 unauthenticated zurückgegeben. Eine First-Party-Anwendung auf einem anderen Origin kann stattdessen ihr Front-API-Zugriffstoken senden (Authorization: DPoP <token> mit einem DPoP-Proof; siehe Front-API-Zugriffstoken).
Mit @keenauth/js: await keenauth.organizations.dismissSuggestion(id).
Anfrage
Header:
| Header | Erforderlich | Beschreibung |
|---|---|---|
Idp-Client |
ja | Kennung des SDK. |
Origin |
ja | Muss genau https://<Anmelde-Host> sein. |
domain_id: die id des Vorschlags (odm_…).
Kein Body (ein leeres JSON-Objekt wird akzeptiert).
Antwort
200 OK mit {"dismiss_count": 1, "hidden": false}. dismiss_count liegt zwischen 1 und 3.
Fehler
| Status | Code | Wann |
|---|---|---|
| 401 | unauthenticated |
Kein gültiges Sitzungs-Cookie oder Front-API-Zugriffstoken. |
| 403 | origin_not_allowed |
Origin fehlt oder ist falsch. |
| 404 | not_found |
Die Domain ist für diesen Benutzer kein Vorschlag oder wurde bereits dreimal abgelehnt. |
| 503 | temporarily_unavailable |
Das Mitgliederverzeichnis hat nicht geantwortet; wiederholen Sie die Anfrage später. |
Beispiel
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
}
Personenbezogene Daten
Dieser Endpunkt verarbeitet personenbezogene Daten: Organisationsmitgliedschaften und Einladungen. Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Übermitteln Sie keine besonderen Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung) in irgendeinem Feld.