
# 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](/docs/api/management/identity-settings/update) 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ığı.

```json
{
  "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

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