Ürün Kullanımı: Superuser

QR kod tarama yaklaşımına ek olarak, Loyetta ürün kullanımını takip etmek için sunucu tarafında bir yöntem sunar. Bu yöntem, ürün kullanımını doğrudan kendi backend'lerinden atamak isteyen müşteriler için tasarlanmıştır — örneğin, sistemleri zaten ürün satın alımlarını yönetiyorsa ve kullanıcıların kod taramasını gerektirmeden sadakat puanı vermek istiyorlarsa.

Nasıl Çalışır

Kullanıcı kendi sisteminiz (ör. POS, e-ticaret) üzerinden bir ürün satın alır
Backend'iniz kullanıcıyı ve satın alınan ürünü tanımlar
Backend'iniz Super-User Token kullanarak Ürün Ata endpoint'ini çağırır
Loyetta ürün kullanımını kaydeder ve kullanıcıya puan verir

Bu yaklaşım önceden oluşturulmuş kodlar gerektirmez. Tamamen sunucudan sunucuya çalışır, bu da POS sistemleri, e-ticaret platformları veya herhangi bir backend satın alma akışı ile otomatik entegrasyonlar için idealdir.

Kullanıcıya Ürün Ata

Superuser tokeni aracılığıyla bir kullanıcıya doğrudan ürün kullanımı atayın. Bu endpoint istemci uygulamasından değil, backend'inizden çağrılır.

POST/v1/superuser/assign-product

Bu endpoint müşteri tokeni değil, Super-User Token gerektirir. Yalnızca backend sunucunuzdan çağrılmalıdır — super-user tokenini asla istemci uygulamalarına açığa çıkarmayın.

user_id ile customer_id'yi karıştırmayın. Burada beklenen user_id parametresi, Loyetta'nın dahili kullanıcı ID'sidir — kimlik doğrulama endpoint'ini çağırdığınızda user nesnesinde dönen id alanıdır. Kimlik doğrulama sırasında gönderdiğiniz customer_id değildir. Örneğin, customer_id: "CUS-123456" ile kimlik doğrulama yapıp yanıtta user.id: 42 alıyorsanız, bu endpoint'e user_id: 42 göndermelisiniz.

İstek Gövdesi

Parametre	Tür	Zorunlu	Açıklama
`user_id`	integer	Evet	Loyetta'nın dahili kullanıcı ID'si (kimlik doğrulama endpoint'inden dönen `user` nesnesindeki `id`)
`product_id`	string	Evet	Loyetta ürün ID'si (ürünler tablosunda mevcut olmalı)
`quantity`	integer	Evet	Atanacak ürün sayısı (min: 1, maks: 50)

Örnek İstek

bash

curl -X POST "https://marka.prod.loyetta.com/api/v1/superuser/assign-product" \
  -H "Authorization: Bearer {super_user_token}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "user_id": 42,
    "product_id": "01jd4k8m2n3p5q7r9abc",
    "quantity": 3
  }'

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

json

{
  "success": true
}

Hata Yanıtları

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

json

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

422 - Kullanıcı Bulunamadı

json

{
  "success": false,
  "message": "Kullanıcı bulunamadı"
}

422 - Ürün Bulunamadı

json

{
  "success": false,
  "message": "Ürün bulunamadı"
}

422 - Doğrulama Hatası

json

{
  "message": "The user id field is required. (and 2 more errors)",
  "errors": {
    "user_id": ["The user id field is required."],
    "product_id": ["The selected product id is invalid."],
    "quantity": ["The quantity field must be at least 1."]
  }
}

500 - Sunucu Hatası

json

{
  "success": false,
  "message": "Sistem hatası oluştu. Hata Kodu: 1051"
}