Elenca le mie organizzazioni

GET /fapi/v1/me/organizations · chiamato dall'host di accesso dell'ambiente

Elenca le organizzazioni a cui l'utente autenticato può passare in un'applicazione: organizzazioni in cui l'utente ha un'appartenenza attiva, che sono attive e per cui l'applicazione è abilitata, in ordine di slug, al massimo 100. È l'elenco che mostra un selettore di organizzazione e lo stesso elenco che il selettore ospitato delle organizzazioni propone all'accesso, quindi non mostra mai un'organizzazione che l'applicazione non può usare. Nessun elemento è contrassegnato come corrente: l'organizzazione a cui è legato il token della tua applicazione è indicata dall'attributo org_id del token. 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.

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

Richiesta

Intestazioni:

Intestazione	Obbligatoria	Descrizione
`Idp-Client`	sì	Identificatore dell'SDK.

Parametri di query:

Parametro	Obbligatorio	Descrizione
`client_id`	sì	Il `client_id` dell'applicazione di prima parte in cui gira il selettore.

Nessun corpo.

Risposta

200 OK con {"data": [...], "truncated": false}.

Ogni elemento: id (org_…, nella stessa forma dell'attributo org_id del token e del parametro organization), slug, name (nome visualizzato con i caratteri di controllo e bidirezionali rimossi; lo slug quando l'organizzazione non ha un nome; visualizzalo come testo semplice). truncated è true quando l'utente ha più organizzazioni di questo tipo rispetto a quelle elencate.

Errori

Stato	Codice	Quando
401	`unauthenticated`	Nessun cookie di sessione valido.
403	`headless_not_allowed`	L'applicazione è un'applicazione di terze parti.
422	`validation_failed`	`client_id` manca, è vuoto, supera i 255 caratteri, è fornito più di una volta o è sconosciuto (`/client_id`).
503	`temporarily_unavailable`	La directory delle appartenenze non ha risposto; riprova più tardi.

Esempio

curl "https://example.keenauth.app/fapi/v1/me/organizations?client_id=app_01j9zzzzzzzzzzzzzzzzzzzz" \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt

{
  "data": [
    {
      "id": "org_01j9xxxxxxxxxxxxxxxxxxxxxx",
      "slug": "acme",
      "name": "Acme"
    }
  ],
  "truncated": false
}

Dati personali

Questo endpoint tratta dati personali: appartenenze alle organizzazioni e inviti. 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.