Kimlik ayarlarını getir

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

Ortamın kullanıcı adı ayarlarını döndürür (ortam başına tek kaynak). Ayar hiç yazılmadıysa tablo varsayılanları (username_identifier: off, 3-64 karakter, boş ayrılmış liste), ETag: "0" ve updated_at: null döner. ETag yanıt başlığı, PATCH isteğinde If-Match olarak gönderilecek sürümü taşır.

verification_policy (varsayılan before_sign_in) ve unverified_account_ttl_days (varsayılan 7) doğrulanmamış hesap temizliğini yönetir; ayrıntı için Kimlik ayarlarını güncelle sayfasına bakın.

İstek

Bu işlem yol, sorgu ya da gövde alanı almaz. Ortam kimlik bilgisinden gelir.

Yanıt

200 OK; ayarlar ve ETag başlığı.

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

Hatalar

HTTP	code	Ne zaman
401	`unauthenticated`	Kimlik bilgisi yok, geçersiz ya da iptal edilmiş.
403	`insufficient_permissions`	Kimlik bilgisinde gerekli izin yok.
429	`rate_limited`	Hız sınırı aşıldı; `Retry-After` süresinden sonra yeniden deneyin.
503	`service_unavailable`	Bir bağımlılık geçici olarak kullanılamıyor; `Retry-After` süresinden sonra yeniden deneyin.

Örnek

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