/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.
Public Key
Her API isteğindeX-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’dabaseUrlolarak 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.
Originbaş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.
Oturumlar
Oturum süresi (dakika): “Beni hatırla” seçilmemiş oturumların hareketsizlikten sonra ne kadar sürede sona ereceği. Varsayılan1440 (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.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.
