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

# Geliştirici Kaynakları

> Yönetim panelindeki geliştirici kaynakları bölümü ve her kaynağın ne için, nasıl kullanılacağı.

Yönetim panelinde **Ayarlar → Headless API** sayfasının en altında **Geliştirici Kaynakları** bölümü bulunur. Burada Headless ile geliştirme yaparken ihtiyaç duyacağınız dört bağlantı yer alır.

| Kaynak | Adres | Kimler için |
| - | - | - |
| İnteraktif API dokümanı | `/headless/docs` | Geliştiriciler |
| `openapi.json` | `/headless/openapi.json` | Araçlar, kod üreticiler, yapay zeka |
| `llms.txt` | `/headless/llms.txt` | Yapay zeka (kısa dizin) |
| `llms-full.txt` | `/headless/llms-full.txt` | Yapay zeka (tam referans) |

Hepsi sitenizin adresi altındadır, ör. `https://siteniz.com/headless/docs`.

## İnteraktif API dokümanı

Tüm endpoint'leri gruplara ayrılmış, aranabilir ve **tarayıcıdan denenebilir** biçimde sunar. Kimlik doğrulama, parametreler, yanıt örnekleri, hata kodları ve çok dilli kod örnekleri içerir.

**Ne zaman kullanın?** Bir endpoint'in ne döndürdüğünü merak ettiğinizde, hızlıca bir istek denemek istediğinizde ya da hata kodunun anlamını aradığınızda.

Ayrıntılı kullanım: [OpenAPI Dokümanı](https://developer.leaderos.net/headless/tr/openapi.md).

## openapi.json

API'nin makine tarafından okunabilir tanımıdır.

**Ne zaman kullanın?**

* Postman/Insomnia/Bruno'ya koleksiyon aktarmak
* TypeScript tipleri veya başka dillerde istemci üretmek
* Yapay zeka araçlarına tam tanımı vermek
* MCP sunucusunun veri kaynağı (otomatik okur)

## llms.txt

Yapay zeka modelleri için hazırlanmış **kısa** bir dizindir: temel kurallar (kimlik doğrulama, yanıt biçimi, hata yönetimi) ve tüm endpoint'lerin tek satırlık listesi.

**Ne zaman kullanın?** Bağlam penceresi küçük olan bir araca hızlıca genel resmi vermek istediğinizde.

## llms-full.txt

Her endpoint'in parametreleri, istek gövdesi, yanıtları ve hata kodlarıyla **tam** referansıdır. Panelde şu ipucu yazar:

> "llms-full.txt dosyasını yapay zeka asistanınıza verin, sizin için bir tema geliştirebilir."

**Nasıl kullanılır?**

> [tab] Sohbet aracı
>
> Dosyanın içeriğini kopyalayıp sohbete yapıştırın (veya dosya olarak yükleyin) ve isteğinizi yazın:
>
> > "Yukarıdaki API ile Next.js'te bir mağaza sayfası yaz."

> [tab] Kod asistanı
>
> Asistana adresi verin:
>
> > "[https://siteniz.com/headless/llms-full.txt](https://siteniz.com/headless/llms-full.txt) dosyasını oku ve bu API ile bir giriş formu yaz."

> [tab] MCP
>
> MCP sunucusu bunu `leaderos://llms-full.txt` kaynağı olarak otomatik sunar; elle vermenize gerek kalmaz.

## Public key ve API URL

Aynı sayfada üstte bulunan şu bilgiler de geliştirme için gereklidir:

* **Public Key**: her istekte `X-LeaderOS-Key` başlığı ([Yönetim paneli ayarları](https://developer.leaderos.net/headless/tr/dashboard-settings.md))
* **API URL**: `https://siteniz.com/headless/v1`

## Önerilen geliştirme akışı

**1. Keşfedin**

İnteraktif dokümanda endpoint'leri gezin ve birkaçını deneyin.

**2. Başlayın**

`npm create leaderos-theme@latest` ile şablonu kurun ([create-leaderos-theme](https://developer.leaderos.net/headless/tr/create-leaderos-theme.md)).

**3. Yapay zekayı bağlayın**

MCP ve `llms-full.txt` ile asistanı projeye bağlayın ([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)).

## Yardım

> [card] [API temelleri](https://developer.leaderos.net/headless/tr/api-basics.md)
>
> Kimlik doğrulama, hatalar, captcha, ödeme akışı.

> [card] [Ayarlar](https://developer.leaderos.net/headless/tr/dashboard-settings.md)
>
> Panel ayarlarının tam açıklaması.


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