Ana içeriğe atla
Headless API’yi fetch ile elle çağırabilirsiniz, ancak resmi paketler tip güvenliği, hata yönetimi ve Next.js entegrasyonu sağlar.
create-leaderos-theme kullanıyorsanız paketler zaten kurulu gelir. Bu sayfa mevcut bir projeye eklemek veya mantığı anlamak içindir.

@leaderos/headless-sdk

Kurulum

İstemci oluşturma

Kullanım

SDK, API gruplarını birebir yansıtır:
Mevcut gruplar arasında site, auth, account, store, cart, payments, credits, chest, forum, support, blog, help, suggestions, applications, forms ve server (play, vote, staff) bulunur. Hangi metodun hangi endpoint’e karşılık geldiği için OpenAPI’deki operationId değerlerine bakın.

Hata yönetimi

LeaderOSError alanları: code, status, fields, details. message’a göre değil, code’a göre dallanın.

İstek başına seçenekler

Her metodun son parametresi options nesnesidir (query, headers, signal, fetch):

Tipler

OpenAPI’den üretilen tüm şemalar dışa aktarılır:

@leaderos/headless-react

Kurulum

Provider ve hook’lar

<PoweredBy /> bileşenini silmeyin, gizlemeyin veya benzeriyle değiştirmeyin. Yalnızca config.branding.canRemove değeri true ise kaldırılabilir.

Next.js entegrasyonu

Ortam değişkenleri (.env.local):

Sunucu istemcisi (Server Components / Server Actions)

Bu istemci kullanıcı token’ını httpOnly çerezden okur ve ziyaretçinin IP’sini X-Forwarded-For ile API’ye iletir.

Proxy rotası (tarayıcı istekleri)

Tarayıcıdaki istemci (createBrowserClient()) istekleri bu rotaya gönderir. Proxy:
  • public key’i ve kullanıcı token’ını sunucuda ekler (tarayıcı hiçbir zaman token’ı görmez),
  • token’ı giriş/kayıtta httpOnly çereze yazar, şifre/e-posta değişikliğinde yeniler, çıkışta siler,
  • siteler arası (cross-site) yazma isteklerini engeller.
Bu sayede CORS ayarına bile ihtiyaç kalmaz çünkü tarayıcı yalnızca kendi alan adınıza istek atar.
Public key tarayıcıda görünebilir ancak proxy kullanırsanız hiç görünmez. Üretimde proxy kullanmanız önerilir.