Hole die Identitätseinstellungen

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

Gibt die Benutzernamen-Einstellungen der Umgebung zurück (eine Ressource pro Umgebung). Wurden die Einstellungen nie geschrieben, werden die Tabellenstandards zurückgegeben (username_identifier: off, 3–64 Zeichen, leere Liste reservierter Namen) mit ETag: "0" und updated_at: null. Der ETag-Response-Header trägt die Version zum Senden als If-Match auf PATCH.

verification_policy (Standard before_sign_in) und unverified_account_ttl_days (Standard 7) steuern die Bereinigung unbestätigter Konten; siehe Aktualisiere die Identitätseinstellungen.

Anfrage

Diese Operation nimmt keine Pfad-, Query- oder Body-Felder entgegen. Die Umgebung stammt aus den Anmeldedaten.

Antwort

200 OK mit den Einstellungen und dem ETag-Header.

{
  "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"
}

Fehler

HTTP	Code	Wann
401	`unauthenticated`	Die Anmeldedaten fehlen, sind ungültig oder wurden widerrufen.
403	`insufficient_permissions`	Die Anmeldedaten haben nicht die erforderliche Berechtigung.
429	`rate_limited`	Die Rate-Grenze wurde überschritten; Wiederhole nach dem `Retry-After`-Zeitraum.
503	`service_unavailable`	Eine Abhängigkeit ist vorübergehend nicht verfügbar; Wiederhole nach dem `Retry-After`-Zeitraum.

Beispiel

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