> ## Documentation Index
> Fetch the complete documentation index at: https://developer.leaderos.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Yönetim Paneli Ayarları

> Ayarlar → Headless API sayfasındaki her ayarın ne işe yaradığı.

Tüm Headless ayarları yönetim panelinde **Ayarlar → Headless API** altındadır (`/dashboard`). Sayfaya erişmek için **MANAGE\_SETTINGS** yetkisi gerekir. Sayfanın üstündeki **API Dokümantasyonu** düğmesi interaktif dokümanı (`/headless/docs`) yeni sekmede açar.

> [!NOTE]
>
> Headless API bir *modül* değildir; sitenin yerleşik bir özelliğidir. Ayarlar `Settings` tablosunda tutulur ve her değişiklik yönetim günlüğüne kaydedilir.

## Headless API Durumu

Ana şalterdir. Kapalıyken `/headless/v1/*` isteklerinin tamamı `404 HEADLESS_DISABLED` döner. Anahtar değiştirildiği anda kaydedilir, **Kaydet** düğmesine basmanız gerekmez.

> [!TIP]
>
> Temanızı yayına almadan önce API'yi açık bıraktığınızdan emin olun. Bakım yaparken API'yi kapatmak yerine LeaderOS'un **bakım modunu** kullanın; bakım modunda yetkililer API'yi kullanmaya devam eder, diğerleri `503 MAINTENANCE` alır.

## Public Key

Her API isteğinde `X-LeaderOS-Key` başlığında gönderilen anahtardır (`pk_live_` + 32 hex karakter).

* **Public (herkese açık) olacak şekilde tasarlanmıştır**: tarayıcı kodunda bulunabilir. Gizli anahtar (secret key) yoktur. Güvenlik, izin verilen origin'ler ve oyuncu Bearer token'ları ile sağlanır.
* **Kopyala**: anahtarı panoya alır.
* **Yeni Anahtar Oluştur**: yeni bir anahtar üretir. Onay istenir çünkü **eski anahtarı kullanan tüm ön yüzler yeni anahtarı girene kadar çalışmaz** (`INVALID_API_KEY`). Anahtar sızdığını düşündüğünüzde veya ekipten biri ayrıldığında kullanın.
* **API URL**: `https://siteniz.com/headless/v1`. SDK'da `baseUrl` olarak sitenizin kökünü (`https://siteniz.com`) verirsiniz.

## İzin Verilen Origin'ler (CORS)

Tarayıcıdan doğrudan API'ye istek atabilecek web sitelerinin listesi. **Her satıra bir origin** yazın (şema + alan adı + varsa port, yol olmadan):

```
https://shop.example.com
http://localhost:3000
https://*.example.com
```

* `*.` ile alt alan adı joker karakteri kullanılabilir.
* **Sitenizin kendi adresi ve aşağıdaki Frontend URL her zaman izinlidir.**
* `Origin` başlığı göndermeyen istekler (sunucu tarafı, `curl`, mobil uygulama) her zaman kabul edilir; çünkü origin kontrolü yalnızca tarayıcıları hedefler.
* Geçersiz biçim (ör. sonda yol, eksik şema) kaydedilirken hata verir.

### Tüm origin'lere izin ver (yalnızca geliştirme)

Açıldığında origin kontrolü tamamen devre dışı kalır. Yerel geliştirmede işe yarar ancak **canlı sitede kapalı olmalıdır**; aksi halde herhangi bir web sitesi anahtarınızla tarayıcıdan istek atabilir.

## Frontend URL ve Sayfalar

API, e-postalarda ve dış sağlayıcı dönüşlerinde oyuncuyu **sizin ön yüzünüze** yönlendirir. Bu bölümde ön yüzünüzün adresini ve sayfa yollarını tanımlarsınız.

### Frontend URL

Ön yüzünüzün kök adresi, ör. `https://shop.example.com`. **Boş bırakılırsa LeaderOS sitenizin adresi kullanılır.** Sonunda `/` olmamalıdır (kaydederken temizlenir).

### Sayfa yolları

Her satır bir yol şablonudur ve `/` ile başlamalıdır. Boş bırakırsanız varsayılan kullanılır (placeholder olarak gösterilir). `{token}` gibi yer tutucular otomatik doldurulur; **yalnızca satırın yanında listelenen yer tutucular kullanılabilir.**

| Anahtar | Varsayılan yol | Ne zaman kullanılır |
| - | - | - |
| Ana sayfa | `/` | Genel dönüşler, hata sonrası yönlendirme |
| Şifre sıfırlama | `/reset-password/{token}` | Şifre sıfırlama e-postasındaki bağlantı |
| E-posta doğrulama | `/verify-email/{token}` | Doğrulama e-postasındaki bağlantı |
| 2FA kurtarma | `/tfa/recover/{token}` | 2FA kurtarma e-postası |
| E-posta değişikliği onayı | `/account/settings/security/confirm-email-change/{token}` | E-posta değişikliği onay bağlantısı |
| Ödeme başarılı | `/payment/success?order={orderId}` | Ödeme sağlayıcısından başarılı dönüş |
| Ödeme hatası | `/payment/error?order={orderId}&error={error}` | Başarısız/iptal edilen ödeme |
| Manuel ödeme talimatı | `/payment/pay/manual/{orderId}` | Havale/EFT gibi manuel ödemeler |
| Hesap bağlandı | `/account/settings/linked-accounts?status={status}&provider={provider}&message={message}` | Discord ve diğer hesap bağlama dönüşü |
| Giriş geri çağrısı | `/auth/callback?authToken={authToken}&exchange={exchange}&error={error}` | Harici sağlayıcıyla giriş dönüşü |
| Blog yazısı | `/blog/posts/{slug}` | Discord bildirimlerindeki bağlantı |
| Forum konusu | `/forum/threads/{id}/{slug}` | Discord bildirimlerindeki bağlantı |
| Destek talebi | `/support/tickets/{id}` | Discord bildirimlerindeki bağlantı |

> [!WARNING]
>
> Bu sayfaları temanızda **mutlaka oluşturun** ya da yolları kendi sayfalarınıza göre değiştirin. Aksi halde şifre sıfırlama e-postası veya ödeme dönüşü 404 verir. `create-leaderos-theme` ile gelen şablonda hepsi hazırdır.

## Oturumlar

**Oturum süresi (dakika)**: "Beni hatırla" seçilmemiş oturumların hareketsizlikten sonra ne kadar sürede sona ereceği. Varsayılan `1440` (1 gün), izin verilen aralık `5` – `525600`. Her istekte süre uzar. **"Beni hatırla"** ile açılan oturumlar 1 yıl geçerlidir.

Şifre veya e-posta değiştiğinde ana sitedeki gibi tüm oturumlar kapatılır ve değişikliği yapana yeni token verilir (SDK bunu otomatik saklar).

## Endpoint Grupları

Ön yüzünüzün ihtiyaç duymadığı özellik gruplarını kapatabilirsiniz. Kapalı bir grup **404** döner. Sadece **site** grubu kapatılamaz. Kapalı modüllerin grupları zaten kullanılamaz.

| Grup | İçerik |
| - | - |
| Giriş ve Kayıt (`auth`) | Giriş, kayıt, şifre sıfırlama, e-posta |
| Hesap (`account`) | Profil, ayarlar, güvenlik, avatar |
| Mağaza (`store`) | Kategoriler, ürünler |
| Sepet ve Siparişler (`cart`) | Sepet, kupon, sipariş detayı |
| Kredi (`credits`) | Kredi yükleme, gönderme |
| Sandık (`chest`) | Sandık ve hediye etme |
| Hediye Kodları (`gifts`) | Kod kullanma |
| Pazar (`bazaar`) | Oyuncu pazarı |
| Gaming Night (`gaming-night`) | Etkinlik satın alma |
| Şans Çarkı (`fortune-wheel`) | Çark çevirme |
| Blog (`blog`) | Yazılar, kategoriler, yorumlar |
| Forum (`forum`) | Kategoriler, konular, cevaplar |
| Destek (`support`) | Destek talepleri |
| Öneriler (`suggestions`) | Öneri sistemi |
| Yardım Merkezi (`help`) | Makaleler, arama |
| Başvurular (`applications`) | Yetkili başvuruları |
| Formlar (`forms`) | Özel formlar |
| İndirmeler (`downloads`) | Dosyalar |
| Üyeler (`members`) | Üye listesi |
| Skor Tabloları (`leaderboards`) | Sıralamalar |
| Oyunlar (`games`) | Oyun sayfaları |
| Cezalar (`punishments`) | Ceza listesi |
| Değişiklik Günlüğü (`changelog`) | Güncelleme notları |
| Sayfalar (`pages`) | Özel CMS sayfaları |
| Oy Verme (`vote`) | Oy siteleri |
| Yetkililer (`staff`) | Yetkili listesi |
| Discord (`discord`) | Discord bağlama |
| Hesap Bağlama (`account-linking`) | Harici hesap bağlama |
| Yapay Zeka (`ai`) | AI destek yanıtı |

> [!TIP]
>
> Güvenlik açısından en az ayrıcalık ilkesini uygulayın: kullanmadığınız grupları kapatmak saldırı yüzeyini küçültür. Örneğin yalnızca mağaza yapıyorsanız forum, destek ve öneri gruplarını kapatabilirsiniz.

## Geliştirici Kaynakları

Sayfanın altındaki bölüm; interaktif dokümana, `openapi.json`, `llms.txt` ve `llms-full.txt` dosyalarına bağlantılar verir. Ayrıntılar için [Geliştirici kaynakları](https://developer.leaderos.net/headless/tr/developer-resources.md) sayfasına bakın.

## Ayarları kaydetme

Durum anahtarı ve public key işlemleri anında uygulanır. Diğer ayarlar (origin'ler, Frontend URL, sayfa yolları, oturum süresi, gruplar) sayfa sonundaki **Değişiklikleri Kaydet** düğmesiyle kaydedilir.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.