Ana içeriğe atla

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-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:

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

“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.
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ıç
2

Tema oluşturun

npm create leaderos-theme@latest ile hazır projeyi kurun → create-leaderos-theme
3

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