Elenca i miei suggerimenti di organizzazione

GET /fapi/v1/me/organization-suggestions · chiamato dall'host di accesso dell'ambiente

Elenca le organizzazioni a cui l'utente autenticato è invitato ad aderire grazie al dominio di uno dei suoi indirizzi email verificati. Un'organizzazione viene suggerita quando è attiva, ha verificato quel dominio con la cattura del dominio impostata su suggest, e l'utente non ha un'appartenenza in essa (anche un'appartenenza rimossa o abbandonata conta, quindi non viene mai suggerita di nuovo). Viene restituito un elemento per organizzazione, in ordine di slug, per un massimo di 20. Un'organizzazione che l'utente ha ignorato tre volte non viene elencata. Se il ruolo di membro predefinito dell'ambiente non può essere concesso tramite cattura del dominio (un ruolo amministrativo, un ruolo privilegiato, oppure un ruolo con autorizzazioni di sistema oltre alla lettura dell'organizzazione e dei suoi membri), l'elenco è vuoto. La lettura non modifica nulla e non richiede una sessione verificata di recente. Richiede il cookie __Host-idp_session dell'utente autenticato; se il cookie manca, è scaduto o è stato revocato, restituisce 401 unauthenticated. Un'app first-party su un'altra origine può invece inviare il proprio access token Front API (Authorization: DPoP <token> con una prova DPoP; vedi Token di accesso Front API).

Con @keenauth/js: await keenauth.organizations.suggestions().

Richiesta

Intestazioni:

Nessun parametro di query. Nessun corpo.

Risposta

200 OK con {"data": [...]}. La risposta non viene memorizzata nella cache (Cache-Control: no-store).

Ciascun elemento: id (odm_…, il record del dominio verificato; usalo per aderire o ignorare), domain (il dominio email che ha corrisposto) e organization con id (org_…), slug e name (nome visualizzato con i caratteri di controllo e bidirezionali rimossi; lo slug quando l'organizzazione non ha un nome; visualizzalo come testo semplice).

Errori

Esempio

curl https://example.keenauth.app/fapi/v1/me/organization-suggestions \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt

{
  "data": [
    {
      "id": "odm_01j9a5c4000000000000000001",
      "domain": "acme.example",
      "organization": {
        "id": "org_01j9xxxxxxxxxxxxxxxxxxxxxx",
        "slug": "acme",
        "name": "Acme"
      }
    }
  ]
}

Dati personali

Questo endpoint contiene dati personali: appartenenze e inviti alle organizzazioni. Dati personali nelle API di KeenAuth descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene cancellato. Non inviare categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale) in nessun campo.