Ürün Kullanımı: QR Kod

Loyetta, önceden oluşturulmuş QR kodlar aracılığıyla ürün kullanımını takip etmeyi destekler. Bu kodlar Loyetta Dashboard'dan oluşturulur ve doğrudan ürün ambalajlarına basılabilir. Kullanıcı QR kodu taradığında, uygulamanız kodu Loyetta'ya göndererek doğrulama yapar ve puan kazandırır.

Nasıl Çalışır

Her ürün partisi için Loyetta Dashboard'dan kodlar oluşturun
QR kodları fiziksel ürün ambalajlarına basın
Kullanıcı kodu taradığında, uygulamanız kod string'ini yakalar
Uygulamanız taranan kod ile Kod Kullan endpoint'ini çağırır
Loyetta kodu doğrular, puan verir ve sonucu döndürür

Her kod yalnızca bir kez kullanılabilir. Kod kullanıldıktan sonra yapılan her deneme 403 hatası döndürür.

Ürün Kodunu Kullan

Bir ürün kodunu doğrulayın ve kimliği doğrulanmış kullanıcıya puan verin. Kod genellikle ürün üzerindeki QR kodun taranmasıyla elde edilir.

POST/v1/products/use-code

İstek Gövdesi

Parametre	Tür	Zorunlu	Açıklama
`code`	string	Evet	Kullanılacak ürün kodu (ör. `XXXX-YYYYYY`)

Örnek İstek

bash

curl -X POST "https://marka.prod.loyetta.com/api/v1/products/use-code" \
  -H "Authorization: Bearer {musteri-tokeni}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "code": "XXXX-YYYYYY"
  }'

Yanıt (200 - Başarılı)

json

{
  "success": true,
  "earned_points": 200,
  "campaign": "200",
  "eligibleCampaigns": [],
  "campaignText": "<p>Kampanya detayları burada</p>",
  "birthdayText": "<p>Doğum günü bonusu!</p>",
  "user": {
    "points": 1500
  },
  "message": "Tebrikler! 200 puan kazandınız."
}

Yanıt Alanları

Alan	Tür	Açıklama
`success`	boolean	Kodun başarıyla kullanılıp kullanılmadığı
`earned_points`	integer	Bu işlemden kazanılan puan sayısı
`campaign`	string	Kod kullanılarak otomatik olarak bir kampanyaya kaydolunduysa kampanya ID'si
`eligibleCampaigns`	array	Kullanıcının artık uygun olduğu kampanyaların listesi
`campaignText`	string	HTML formatında kampanya özet metni
`birthdayText`	string	HTML formatında doğum günü bonusu metni
`user.points`	integer	Kullanıcının güncellenmiş toplam puan bakiyesi
`message`	string	Okunabilir başarı mesajı

Hata Yanıtları

403 - Geçersiz veya Kullanılmış Kod

json

{
  "success": false,
  "message": "Ürün kodu geçersiz. Hata Kodu: 1051"
}

422 - Doğrulama Hatası

json

{
  "message": "The code field is required.",
  "errors": {
    "code": ["The code field is required."]
  }
}

401 - Yetkisiz

json

{
  "message": "Unauthenticated."
}

Bu endpoint Müşteri Tokeni (kullanıcı başına oturum tokeni) gerektirir. Kullanıcı, ürün kodlarını taramadan önce kimlik doğrulaması yapmalıdır.