Superuser Genel Bakış

Superuser API, Loyetta'nın sunucudan sunucuya (backend-to-backend) entegrasyon yüzeyidir. Kendi sistemlerinizin — faturalandırma, CRM, POS, e-ticaret veya herhangi bir sunucu tarafı servis — bir istemci oturumundan geçmeden, kullanıcılarınız adına sadakat işlemleri yürütmesini sağlar.

Müşteri tokeni endpoint'leri kullanıcının kimliği doğrulanmış oturumundan çağrılırken, superuser endpoint'leri bir ana kimlik bilgisi (master credential) kullanılarak sunucudan sunucuya çağrılır. Kullanıcıları doğrulamak (ve otomatik oluşturmak), ürün kullanımı atamak, özel olaylar (custom events) takip etmek ve abonelikleri yönetmek doğrudan backend'inizden bu şekilde yapılır.

Superuser, otomasyon için tasarlanmış entegrasyon modelidir. Platformunuz bir kullanıcının ne yaptığını zaten biliyorsa — ürün satın aldı, planını yeniledi, bir işlemi tamamladı — bunu bu endpoint'ler aracılığıyla Loyetta'ya yansıtırsınız ve Loyetta bunu puana, kampanya tetikleyicilerine ve segmentasyona dönüştürür.

Superuser Erişim Tokeni

Superuser endpoint'leri, onboarding sırasında Loyetta ekibi tarafından size sağlanan bir superuser erişim tokeni ile yetkilendirilir. Şu formatta görünür:

loy_sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Token, super_user yetkisini taşır. Bu token olmadan (veya normal bir müşteri tokeni ile) yapılan her istek 403 Operation not allowed. ile reddedilir.

Superuser tokenini gizli bir anahtar gibi koruyun. Tenant'ınıza tam backend erişimi sağlar. Yalnızca kendi sunucularınızdan kullanın — asla bir mobil uygulamaya, tarayıcıya veya son kullanıcının kontrol ettiği herhangi bir istemciye gömmeyin. Bir token açığa çıkarsa, rotasyonu için Loyetta ekibiyle iletişime geçin.

Temel URL

Tüm superuser endpoint'leri, tenant host'unuzda /v1/superuser öneki altında yer alır:

https://{customer-id}.prod.loyetta.com/api/v1/superuser

Header'lar

Header	Değer	Zorunlu
`Authorization`	`Bearer loy_sk_live_xxxx`	Evet
`Content-Type`	`application/json`	Evet
`Accept`	`application/json`	Evet

user_id ve customer_id

Çoğu superuser endpoint'i, bir kullanıcıyı kendi customer_id'niz ile değil, Loyetta'nın dahili kullanıcı ID'si (user.id) ile referans alır. Dahili user.id'yi, kullanıcı yoksa onu oluşturan kimlik doğrulama endpoint'inin yanıtından elde edersiniz.

user_id ile customer_id'yi karıştırmayın. user_id, kimlik doğrulamadan user.id olarak dönen Loyetta'nın dahili ID'sidir. customer_id ise kimlik doğrulamaya gönderdiğiniz kendi tanımlayıcınızdır. Örneğin, customer_id: "CUS-123456" ile doğrulama yaptığınızda user.id: 42 dönebilir — superuser endpoint'lerine geçireceğiniz değer 42'dir.

Mevcut Superuser Endpoint'leri

Alan	Endpoint	Açıklama
Kimlik Doğrulama	`POST /v1/superuser/authenticate`	Bir kullanıcının kimliğini doğrular ve otomatik oluşturur; `user.id` ve oturum tokenini döner. Kimlik Doğrulama.
Ürün Kullanımı	`POST /v1/superuser/assign-product`	Backend'inizden bir kullanıcıya ürün kullanımı atar. Ürün Kullanımı.
Özel Olaylar	`POST /v1/superuser/track-event`	Bir kullanıcı için özel olay kaydı oluşturur. Olay Takibi.
Puan & Kupon	`GET /v1/superuser/user-points`	Bir kullanıcının puan bakiyesini ve kullanabileceği kupon kodlarını sorgular. Puan & Kupon Sorgulama.
Abonelikler	`POST /v1/superuser/subscribe` ve `/subscriptions/*`	Kullanıcı aboneliklerini oluşturur ve yönetir. Abonelikler.

Yaygın Hata Yanıtları

403 — Yasak (token super_user yetkisine sahip değil)

json

{
  "message": "Operation not allowed."
}

422 — İşlenemeyen İçerik (doğrulama başarısız)

json

{
  "message": "The given data was invalid.",
  "errors": {
    "field_name": ["Error message"]
  }
}