GurStore için Sepet API Uç Noktaları

GurStore sepet API’si, bir müşterinin alışveriş oturumunu programatik olarak yönetmenizi sağlar — güncel sepet durumunu alın, isteğe bağlı varyant seçimiyle ürün ekleyin ve indirim için kupon kodları uygulayın. Tüm sepet uç noktaları geçerli bir bearer belirteci gerektirir. Sepet, kimliği doğrulanmış müşterinin oturumuna bağlıdır; bu yüzden her belirteç aynı anda tam olarak bir sepete karşılık gelir.

Sepet içeriğini al

Kimliği doğrulanmış müşteri için tüm satır öğeleri, adetler, uygulanan kuponlar ve çalışan toplamlar dahil güncel sepeti döndürür.

GET /api/store/cart

Kimlik doğrulama: Bearer belirteci gerekir

Örnek istek

curl https://magazaniz.com/api/store/cart \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

Örnek yanıt

{
  "status": "success",
  "data": {
    "items": [
      {
        "product_id": 1,
        "variant_id": 2,
        "name": "Pro License",
        "quantity": 1,
        "unit_price": 29.99,
        "subtotal": 29.99
      }
    ],
    "coupon": null,
    "discount": 0,
    "total": 29.99
  }
}

Yanıt alanları

string

Geçerli bir 200 yanıtında "success".

array

Sepette şu anda bulunan satır öğesi nesnelerinden oluşan bir dizi. Sepet boşsa boş dizi döndürür.

integer

Bu satır öğesindeki ürünün kimliği.

integer

Varsa seçilen ürün varyantının kimliği.

string

Ürünün görünen adı.

integer

Bu satır öğesindeki birim sayısı.

number

Öğe eklendiğinde birim başına fiyat.

number

Satır öğesi toplamı (unit_price × quantity).

string | null

Sepete uygulanan kupon kodu ya da hiçbiri uygulanmadıysa null.

number

Aktif kuponun uyguladığı toplam indirim tutarı. Kupon yoksa 0.

number

İndirimlerden sonra nihai sepet toplamı.

Sepete öğe ekle

Kimliği doğrulanmış müşterinin sepetine bir ürün (isteğe bağlı bir varyantla) ekler. Ürün zaten sepetteyse adet artırılır.

POST /api/store/cart/add

Kimlik doğrulama: Bearer belirteci gerekir

İstek gövdesi

integer

required

Sepete eklenecek ürünün kimliği. Ürün kimliklerini GET /api/store/products’tan alabilirsiniz.

integer

Belirli bir ürün varyantının kimliği (ör. lisans kademesi, koltuk sayısı veya plan). Ürünün varyantları olduğunda zorunludur; varyantı olmayan ürünlerde atlayın.

integer

required

Eklenecek birim sayısı. Pozitif bir tamsayı olmalıdır. Tek lisanslı dijital ürünler için 1 kullanın.

Örnek istek

curl -X POST https://magazaniz.com/api/store/cart/add \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"product_id": 1, "variant_id": 2, "quantity": 1}'

Örnek yanıt

{
  "status": "success",
  "data": {
    "items": [
      {
        "product_id": 1,
        "variant_id": 2,
        "name": "Pro License",
        "quantity": 1,
        "unit_price": 29.99,
        "subtotal": 29.99
      }
    ],
    "coupon": null,
    "discount": 0,
    "total": 29.99
  }
}

Yanıt, öğe eklendikten sonra güncellenmiş sepet durumunun tamamını döndürür — GET /api/store/cart ile aynı biçim.

Kupon kodu uygula

Kimliği doğrulanmış müşterinin aktif sepetine bir indirim kuponu uygular. Geçerliyse sepet toplamı, indirim uygulanarak yeniden hesaplanır.

POST /api/store/cart/coupon

Kimlik doğrulama: Bearer belirteci gerekir

İstek gövdesi

string

required

Sepete uygulanacak kupon kodu (ör. "LAUNCH20"). Kodlar büyük/küçük harfe duyarsızdır.

Örnek istek

curl -X POST https://magazaniz.com/api/store/cart/coupon \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"code": "LAUNCH20"}'

Örnek başarılı yanıt

{
  "status": "success",
  "data": {
    "items": [
      {
        "product_id": 1,
        "variant_id": 2,
        "name": "Pro License",
        "quantity": 1,
        "unit_price": 29.99,
        "subtotal": 29.99
      }
    ],
    "coupon": "LAUNCH20",
    "discount": 6.00,
    "total": 23.99
  }
}

Örnek hata yanıtı

{
  "status": "error",
  "message": "The coupon code LAUNCH20 is invalid or has expired."
}

Kuponlar oturum başına tek kullanımlıktır. Bir kupon sepete uygulanıp sepet ödemeye ilerlediğinde, kupon yeni bir oturum için yeniden kullanılamaz. Bir kupon uygulayıp ardından sepeti temizlerseniz, ödeme yapmadan önce yeniden uygulamanız gerekebilir.

Genel Bakış

Mağaza (Storefront)

Müşteri API

Özel API v1

Webhooks

GurStore için Sepet API Uç Noktaları

Sepet içeriğini al

Örnek istek

Örnek yanıt

Yanıt alanları

Sepete öğe ekle

İstek gövdesi

Örnek istek

Örnek yanıt

Kupon kodu uygula

İstek gövdesi

Örnek istek

Örnek başarılı yanıt

Örnek hata yanıtı

​Sepet içeriğini al

​Örnek istek

​Örnek yanıt

​Yanıt alanları

​Sepete öğe ekle

​İstek gövdesi

​Örnek istek

​Örnek yanıt

​Kupon kodu uygula

​İstek gövdesi

​Örnek istek

​Örnek başarılı yanıt

​Örnek hata yanıtı

Sepet içeriğini al

Örnek istek

Örnek yanıt

Yanıt alanları

Sepete öğe ekle

İstek gövdesi

Örnek istek

Örnek yanıt

Kupon kodu uygula

İstek gövdesi

Örnek istek

Örnek başarılı yanıt

Örnek hata yanıtı