Hızlı Başlangıç Rehberi
Bu rehber, Loyetta'yı sisteminize entegre etmeniz için gereken mimari adımları özetlemektedir. Loyetta "backend-first" (önce arka uç) bir çözüm olduğundan, sunucunuz kullanıcılarınız ile sadakat motorumuz arasında bir köprü görevi görür.
Başlamak için ortam URL'lerinizi yapılandırmanız ve kimlik doğrulama "el sıkışmasını" (handshake) uygulamanız gerekir.
1. Temel URL (Base URL) Yapılandırması
Loyetta multi-tenant bir mimaride çalışır. Bu, verilerinizin diğer müşterilerden izole edilmiş, size özel bir ortamda bulunduğu anlamına gelir. Genel bir API adresi kullanmazsınız; bunun yerine API'ye kendi Alt Alan Adınız (Subdomain) üzerinden erişirsiniz.
Endpoint Yapınız:
| Ortam | URL |
|---|---|
| Production | https://{musteri-id}.prod.loyetta.com/api |
| Staging | https://{musteri-id}.stag.loyetta.com/api |
- Müşteri ID: Size atanan benzersiz kimlik (örneğin:
markaniz).
Geliştirme ve test için staging ortamını kullanın. Canlıya geçmeye hazır olduğunuzda production'a geçin.
2. Kimlik Doğrulama "El Sıkışması"
Loyetta, kullanıcılarınızın şifrelerini veya kayıt formlarını doğrudan yönetmez. Bunun yerine, kullanıcının kim olduğunu bize bildirmesi için sizin backend sisteminize güveniriz. Bu işlem, bir Süper Kullanıcı token takası ile yapılır.
Kavram
- Backend'iniz bir ana anahtara (Süper Kullanıcı Token'ı) sahiptir.
- Kullanıcınız uygulamanıza normal şekilde giriş yapar.
- Backend'iniz Loyetta'ya sorar: "Bana X Kullanıcısı için bir oturum token'ı ver."
- Loyetta, X Kullanıcısı için geçici bir oturum token'ı döndürür.
- Backend'iniz / Uygulamanız, gelecekteki tüm isteklerde (puan sorgulama, ürün alma vb.) bu oturum token'ını kullanır.