> ## 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.

# Headless API Nedir?

> LeaderOS Headless API'ye genel bakış: ne işe yarar, nasıl çalışır ve hangi araçlarla birlikte gelir.

## Headless API nedir?

LeaderOS normalde hazır bir tema (ör. `flat`) ile gelir ve sayfaları sunucu tarafında PHP ile üretir. **Headless API**, aynı sitenin tüm oyuncu tarafı özelliklerini (giriş, mağaza, sepet, ödeme, kredi, forum, destek, blog, oy verme vb.) **JSON API** olarak dışarı açar.

Böylece LeaderOS'u arka uç (backend) olarak kullanıp ön yüzü (frontend) dilediğiniz teknoloji ile yazabilirsiniz: React, Next.js, Vue, Nuxt, Svelte, mobil uygulama veya herhangi bir HTTP istemcisi.

> [card] Kendi temanızı yazın
>
> Tasarım üzerinde tam kontrol. Tema dosyalarıyla sınırlı kalmadan modern bir React/Next.js sitesi yapın.

> [card] Aynı iş kuralları
>
> Doğrulama, izinler, ban, bakım modu, 2FA ve e-posta doğrulaması ana siteyle birebir aynı çalışır.

> [card] Yapay zeka dostu
>
> OpenAPI, `llms.txt`, MCP sunucusu ve hazır `AGENTS.md` ile bir yapay zeka asistanı temanızı sizin yerinize geliştirebilir.

> [card] Tipli SDK
>
> TypeScript SDK ve React/Next.js paketi ile her endpoint için otomatik tamamlama ve tip güvenliği.

## Nasıl çalışır?

```
┌──────────────────────┐        ┌────────────────────────────┐
│  Sizin ön yüzünüz    │  JSON  │  LeaderOS sitesi           │
│  (Next.js / React…)  │ ─────► │  https://siteniz.com       │
│  kendi VDS'inizde    │ ◄───── │  /headless/v1/...          │
└──────────────────────┘        └────────────────────────────┘
        oyuncu                    veritabanı, ödeme, oyun sunucusu
```

* LeaderOS sitesi **olduğu gibi çalışmaya devam eder**: yönetim paneli, veritabanı, ödeme geri dönüşleri, oyun sunucusu komutları hep orada kalır.
* Ön yüzünüz `https://siteniz.com/headless/v1/...` adresine istek atar.
* Her istek `X-LeaderOS-Key` başlığında **public key** taşır. Giriş yapmış oyuncular ayrıca `Authorization: Bearer <token>` gönderir.
* Yanıtlar her zaman aynı biçimdedir:

```json theme={null}
{ "success": true, "data": { "...": "..." }, "meta": { "pagination": {}, "seo": {} } }
```

```json theme={null}
{ "success": false, "error": { "code": "VALIDATION_FAILED", "message": "…", "fields": { "email": { "required": "…" } } } }
```

## Neler sunar?

| Alan | Kapsam |
| - | - |
| Site | Yapılandırma, menüler, çeviriler, yönlendirmeler, sitemap, ana sayfa |
| Kimlik | Giriş, kayıt, şifre sıfırlama, 2FA, e-posta doğrulama, harici giriş sağlayıcıları |
| Hesap | Profil, avatar, ayarlar, siparişler, abonelikler, kredi geçmişi, bağlı hesaplar, Discord |
| Ticaret | Mağaza, sepet, kuponlar, ödeme, kredi yükleme/gönderme, sandık, hediye kodları, pazar, Gaming Night, Şans Çarkı |
| Topluluk | Forum, öneriler, destek talepleri, başvurular, formlar, yardım merkezi |
| İçerik | Blog, sayfalar, indirmeler, üyeler, skor tabloları, cezalar, değişiklik günlüğü, yetkililer, oy verme |
| Yapay zeka | Destek taleplerinde yapay zeka yanıtı |

Toplam **160'tan fazla endpoint** vardır ve hepsi interaktif dokümanda listelenir (bkz. [OpenAPI](https://developer.leaderos.net/headless/tr/openapi.md)).

> [!NOTE]
>
> Tebex Store modülü Headless API kapsamında **değildir**. Tebex ödeme geçidi (`TebexCheckout`) ise desteklenir.

## Ekosistem

> [card] [@leaderos/headless-sdk](https://developer.leaderos.net/headless/tr/sdk-and-react.md)
>
> Framework'ten bağımsız TypeScript istemcisi.

> [card] [@leaderos/headless-react](https://developer.leaderos.net/headless/tr/sdk-and-react.md)
>
> Provider, hook'lar, `<PoweredBy/>`, Turnstile ve Next.js yardımcıları.

> [card] [create-leaderos-theme](https://developer.leaderos.net/headless/tr/create-leaderos-theme.md)
>
> Tek komutla hazır Next.js tema projesi.

> [card] [@leaderos/headless-mcp](https://developer.leaderos.net/headless/tr/mcp.md)
>
> Yapay zeka asistanları için MCP sunucusu.

> [card] [OpenAPI & llms.txt](https://developer.leaderos.net/headless/tr/openapi.md)
>
> Makine tarafından okunabilir API tanımı.

> [card] [Yayına alma](https://developer.leaderos.net/headless/tr/deployment.md)
>
> Temanızı kendi VDS'inizde çalıştırın.

## Önemli kurallar

> [!WARNING]
>
> **"Powered by LeaderOS" bağlantısı zorunludur.** Lisans gereği ön yüzünüzde `<PoweredBy />` bileşeni (veya aynı bağlantı) görünür kalmalıdır. Yalnızca marka kaldırma lisansınız varsa (`config.branding.canRemove = true`) kaldırılabilir.

> [!WARNING]
>
> Headless API'yi çalıştıran LeaderOS sitesinin **geçerli bir lisansı** olmalıdır. Lisans, sunucu tarafında alan adı bazlı doğrulanır; geçersiz veya süresi dolmuş lisans `LICENSE_INVALID` / `LICENSE_EXPIRED` (HTTP 402) hatası döndürür.

## Nereden başlamalı?

**1. Etkinleştirin**

Yönetim panelinden Headless API'yi açın ve public key'i alın → [Hızlı başlangıç](https://developer.leaderos.net/headless/tr/quickstart.md)

**2. Tema oluşturun**

`npm create leaderos-theme@latest` ile hazır projeyi kurun → [create-leaderos-theme](https://developer.leaderos.net/headless/tr/create-leaderos-theme.md)

**3. Geliştirin**

Elle ya da yapay zeka ile geliştirin → [Yapay zeka ile geliştirme](https://developer.leaderos.net/headless/tr/ai-development.md)

**4. Yayınlayın**

VDS'inize kurun → [Yayına alma](https://developer.leaderos.net/headless/tr/deployment.md)


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