Ana içeriğe atla
Tüm Headless ayarları yönetim panelinde Ayarlar → Headless API altındadır (/dashboard). Sayfaya erişmek için MANAGE_SETTINGS yetkisi gerekir. Sayfanın üstündeki API Dokümantasyonu düğmesi interaktif dokümanı (/headless/docs) yeni sekmede açar.
Headless API bir modül değildir; sitenin yerleşik bir özelliğidir. Ayarlar Settings tablosunda tutulur ve her değişiklik yönetim günlüğüne kaydedilir.

Headless API Durumu

Ana şalterdir. Kapalıyken /headless/v1/* isteklerinin tamamı 404 HEADLESS_DISABLED döner. Anahtar değiştirildiği anda kaydedilir, Kaydet düğmesine basmanız gerekmez.
Temanızı yayına almadan önce API’yi açık bıraktığınızdan emin olun. Bakım yaparken API’yi kapatmak yerine LeaderOS’un bakım modunu kullanın; bakım modunda yetkililer API’yi kullanmaya devam eder, diğerleri 503 MAINTENANCE alır.

Public Key

Her API isteğinde X-LeaderOS-Key başlığında gönderilen anahtardır (pk_live_ + 32 hex karakter).
  • Public (herkese açık) olacak şekilde tasarlanmıştır: tarayıcı kodunda bulunabilir. Gizli anahtar (secret key) yoktur. Güvenlik, izin verilen origin’ler ve oyuncu Bearer token’ları ile sağlanır.
  • Kopyala: anahtarı panoya alır.
  • Yeni Anahtar Oluştur: yeni bir anahtar üretir. Onay istenir çünkü eski anahtarı kullanan tüm ön yüzler yeni anahtarı girene kadar çalışmaz (INVALID_API_KEY). Anahtar sızdığını düşündüğünüzde veya ekipten biri ayrıldığında kullanın.
  • API URL: https://siteniz.com/headless/v1. SDK’da baseUrl olarak sitenizin kökünü (https://siteniz.com) verirsiniz.

İzin Verilen Origin’ler (CORS)

Tarayıcıdan doğrudan API’ye istek atabilecek web sitelerinin listesi. Her satıra bir origin yazın (şema + alan adı + varsa port, yol olmadan):
  • *. ile alt alan adı joker karakteri kullanılabilir.
  • Sitenizin kendi adresi ve aşağıdaki Frontend URL her zaman izinlidir.
  • Origin başlığı göndermeyen istekler (sunucu tarafı, curl, mobil uygulama) her zaman kabul edilir; çünkü origin kontrolü yalnızca tarayıcıları hedefler.
  • Geçersiz biçim (ör. sonda yol, eksik şema) kaydedilirken hata verir.

Tüm origin’lere izin ver (yalnızca geliştirme)

Açıldığında origin kontrolü tamamen devre dışı kalır. Yerel geliştirmede işe yarar ancak canlı sitede kapalı olmalıdır; aksi halde herhangi bir web sitesi anahtarınızla tarayıcıdan istek atabilir.

Frontend URL ve Sayfalar

API, e-postalarda ve dış sağlayıcı dönüşlerinde oyuncuyu sizin ön yüzünüze yönlendirir. Bu bölümde ön yüzünüzün adresini ve sayfa yollarını tanımlarsınız.

Frontend URL

Ön yüzünüzün kök adresi, ör. https://shop.example.com. Boş bırakılırsa LeaderOS sitenizin adresi kullanılır. Sonunda / olmamalıdır (kaydederken temizlenir).

Sayfa yolları

Her satır bir yol şablonudur ve / ile başlamalıdır. Boş bırakırsanız varsayılan kullanılır (placeholder olarak gösterilir). {token} gibi yer tutucular otomatik doldurulur; yalnızca satırın yanında listelenen yer tutucular kullanılabilir.
Bu sayfaları temanızda mutlaka oluşturun ya da yolları kendi sayfalarınıza göre değiştirin. Aksi halde şifre sıfırlama e-postası veya ödeme dönüşü 404 verir. create-leaderos-theme ile gelen şablonda hepsi hazırdır.

Oturumlar

Oturum süresi (dakika): “Beni hatırla” seçilmemiş oturumların hareketsizlikten sonra ne kadar sürede sona ereceği. Varsayılan 1440 (1 gün), izin verilen aralık 5 – 525600. Her istekte süre uzar. “Beni hatırla” ile açılan oturumlar 1 yıl geçerlidir. Şifre veya e-posta değiştiğinde ana sitedeki gibi tüm oturumlar kapatılır ve değişikliği yapana yeni token verilir (SDK bunu otomatik saklar).

Endpoint Grupları

Ön yüzünüzün ihtiyaç duymadığı özellik gruplarını kapatabilirsiniz. Kapalı bir grup 404 döner. Sadece site grubu kapatılamaz. Kapalı modüllerin grupları zaten kullanılamaz.
Güvenlik açısından en az ayrıcalık ilkesini uygulayın: kullanmadığınız grupları kapatmak saldırı yüzeyini küçültür. Örneğin yalnızca mağaza yapıyorsanız forum, destek ve öneri gruplarını kapatabilirsiniz.

Geliştirici Kaynakları

Sayfanın altındaki bölüm; interaktif dokümana, openapi.json, llms.txt ve llms-full.txt dosyalarına bağlantılar verir. Ayrıntılar için Geliştirici kaynakları sayfasına bakın.

Ayarları kaydetme

Durum anahtarı ve public key işlemleri anında uygulanır. Diğer ayarlar (origin’ler, Frontend URL, sayfa yolları, oturum süresi, gruplar) sayfa sonundaki Değişiklikleri Kaydet düğmesiyle kaydedilir.