Ottenere le impostazioni di identità

GET /v1/identity-settings · permesso identity-settings:read

Restituisce le impostazioni del nome utente dell'ambiente (una risorsa per ambiente). Se le impostazioni non sono mai state scritte, vengono restituiti i valori predefiniti della tabella (username_identifier: off, 3-64 caratteri, elenco riservato vuoto) con ETag: "0" e updated_at: null. L'header di risposta ETag contiene la versione da inviare come If-Match su PATCH.

verification_policy (predefinito before_sign_in) e unverified_account_ttl_days (predefinito 7) controllano la pulizia degli account non verificati; vedere Aggiornare le impostazioni di identità.

Richiesta

Questa operazione non accetta campi di percorso, query o corpo. L'ambiente deriva dalla credenziale.

Risposta

200 OK con le impostazioni e l'header ETag.

{
  "username_identifier": "optional",
  "username_min_length": 3,
  "username_max_length": 32,
  "reserved_usernames": ["admin", "root", "support"],
  "verification_policy": "before_sign_in",
  "unverified_account_ttl_days": 7,
  "updated_at": "2026-10-05T09:30:00.123456Z"
}

Errori

HTTP	code	Quando
401	`unauthenticated`	La credenziale è mancante, non valida o revocata.
403	`insufficient_permissions`	La credenziale non ha il permesso richiesto.
429	`rate_limited`	Il limite di velocità è stato superato; riprova dopo il periodo `Retry-After`.
503	`service_unavailable`	Una dipendenza è temporaneamente non disponibile; riprova dopo il periodo `Retry-After`.

Esempio

curl https://api.eu.keenauth.com/v1/identity-settings \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"