Obtenir les paramètres d'identité

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

Retourne les paramètres de nom d'utilisateur de l'environnement (une ressource par environnement). Si les paramètres n'ont jamais été écrits, les valeurs par défaut de la table sont retournées (username_identifier: off, 3 à 64 caractères, liste réservée vide) avec ETag: "0" et updated_at: null. L'en-tête de réponse ETag porte la version à envoyer comme If-Match sur PATCH.

verification_policy (before_sign_in par défaut) et unverified_account_ttl_days (7 par défaut) pilotent le nettoyage des comptes non vérifiés ; voir Mettre à jour les paramètres d'identité.

Requête

Cette opération n'accepte aucun champ de chemin, de requête ou de corps. L'environnement provient de l'authentification.

Réponse

200 OK avec les paramètres et l'en-tête 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"
}

Erreurs

HTTP	code	Quand
401	`unauthenticated`	L'authentification est manquante, invalide ou révoquée.
403	`insufficient_permissions`	L'authentification manque la permission requise.
429	`rate_limited`	La limite de débit a été dépassée ; réessayez après la période `Retry-After`.
503	`service_unavailable`	Une dépendance est temporairement indisponible ; réessayez après la période `Retry-After`.

Exemple

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