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

# Hızlı Başlangıç

> Headless API'yi açın, public key'i alın ve ilk isteğinizi 5 dakikada gönderin.

## 1. Headless API'yi etkinleştirin

**1. Yönetim paneline girin**

`https://siteniz.com/dashboard` adresinden giriş yapın. Bu sayfa için **MANAGE\_SETTINGS** yetkisi gerekir.

**2. Ayarlar → Headless API sayfasını açın**

**Headless API Durumu** anahtarını açın. Değişiklik anında kaydedilir.

**3. Public key'i kopyalayın**

`pk_live_` ile başlayan anahtarı **Kopyala** düğmesiyle alın. Ayrıca sayfada **API URL** alanı vardır: `https://siteniz.com/headless/v1`

> [!NOTE]
>
> Headless API kapalıyken tüm istekler `404 HEADLESS_DISABLED` döner. Ayrıntılı ayarlar için [Yönetim paneli ayarları](https://developer.leaderos.net/headless/tr/dashboard-settings.md) sayfasına bakın.

## 2. İlk isteğinizi gönderin

```bash theme={null}
curl -H "X-LeaderOS-Key: pk_live_XXXXXXXX" \
     -H "X-Locale: tr" \
     https://siteniz.com/headless/v1/site/config
```

Başarılı yanıt site adını, sürümü, aktif modülleri, para birimlerini, captcha ayarlarını ve marka kuralını içerir:

```json theme={null}
{
  "success": true,
  "data": {
    "name": "Sunucum",
    "version": "6.4.0",
    "modules": { "store": { "active": true }, "forum": { "active": true } },
    "branding": { "canRemove": false }
  }
}
```

## 3. Giriş yapın

```bash theme={null}
curl -X POST https://siteniz.com/headless/v1/auth/login \
  -H "X-LeaderOS-Key: pk_live_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{"username":"oyuncu","password":"sifre"}'
```

Yanıttaki `data.token` değerini sonraki isteklerde gönderin:

```bash theme={null}
curl -H "X-LeaderOS-Key: pk_live_XXXXXXXX" \
     -H "Authorization: Bearer <token>" \
     https://siteniz.com/headless/v1/auth/me
```

## 4. SDK ile aynı işlem

```ts theme={null}
import { createClient } from '@leaderos/headless-sdk';

const leaderos = createClient({
  baseUrl: 'https://siteniz.com',
  publicKey: 'pk_live_XXXXXXXX',
});

const { data: config } = await leaderos.site.config();
console.log(config.name);
```

## 5. Tarayıcıdan istek atıyorsanız

Tarayıcı kaynaklı istekler `Origin` başlığı taşır ve yalnızca **izin verilen origin'lerden** kabul edilir. Geliştirme sırasında `http://localhost:3000` adresini **Ayarlar → Headless API → İzin verilen origin'ler** alanına ekleyin. Sunucu tarafı istekler (ör. Next.js Server Components) `Origin` taşımaz ve her zaman kabul edilir.

## Sık karşılaşılan hatalar

| Kod | Sebep | Çözüm |
| - | - | - |
| `HEADLESS_DISABLED` | Headless API kapalı | Panelden açın |
| `MISSING_API_KEY` | `X-LeaderOS-Key` gönderilmedi | Başlığı ekleyin |
| `INVALID_API_KEY` | Anahtar yanlış veya yenilenmiş | Panelden güncel anahtarı kopyalayın |
| `ORIGIN_NOT_ALLOWED` | Tarayıcı origin'i izinli değil | Origin'i listeye ekleyin |
| `LICENSE_INVALID` | Alan adı lisanslı değil | Lisansınızı kontrol edin |

Tam liste için [API temelleri](https://developer.leaderos.net/headless/tr/api-basics.md) sayfasına bakın.

## Sonraki adım

> [card] [Hazır tema kurun](https://developer.leaderos.net/headless/tr/create-leaderos-theme.md)
>
> Sıfırdan başlamayın: tek komutla çalışan bir Next.js teması oluşturun.


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