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.
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.
Aynı iş kuralları
Doğrulama, izinler, ban, bakım modu, 2FA ve e-posta doğrulaması ana siteyle birebir aynı çalışır.
Yapay zeka dostu
OpenAPI,
llms.txt, MCP sunucusu ve hazır AGENTS.md ile bir yapay zeka asistanı temanızı sizin yerinize geliştirebilir.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?
- 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-Keybaşlığında public key taşır. Giriş yapmış oyuncular ayrıcaAuthorization: Bearer <token>gönderir. - Yanıtlar her zaman aynı biçimdedir:
Neler sunar?
Toplam 160’tan fazla endpoint vardır ve hepsi interaktif dokümanda listelenir (bkz. OpenAPI).
Tebex Store modülü Headless API kapsamında değildir. Tebex ödeme geçidi (
TebexCheckout) ise desteklenir.Ekosistem
@leaderos/headless-sdk
Framework’ten bağımsız TypeScript istemcisi.
@leaderos/headless-react
Provider, hook’lar,
<PoweredBy/>, Turnstile ve Next.js yardımcıları.create-leaderos-theme
Tek komutla hazır Next.js tema projesi.
@leaderos/headless-mcp
Yapay zeka asistanları için MCP sunucusu.
OpenAPI & llms.txt
Makine tarafından okunabilir API tanımı.
Yayına alma
Temanızı kendi VDS’inizde çalıştırın.
Önemli kurallar
Nereden başlamalı?
1
Etkinleştirin
Yönetim panelinden Headless API’yi açın ve public key’i alın → Hızlı başlangıç
2
Tema oluşturun
npm create leaderos-theme@latest ile hazır projeyi kurun → create-leaderos-theme3
Geliştirin
Elle ya da yapay zeka ile geliştirin → Yapay zeka ile geliştirme
4
Yayınlayın
VDS’inize kurun → Yayına alma
