E-Ticaret

cart

12 uç · /api/shop/v1/cart

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 12 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.

POST/api/shop/v1/storefront/cart

VPOS tanımı ekle/güncelle (upsert bank). bank 1-32 char, threed_mode 3d|non3d. config_ref saklanır

Oturum

ama response'ta dönmez.

İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/cart" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/storefront/cart/{token}

Admin: retention config oku (gün eşikleri; null = o tablo için kapalı).

OturumYol parametresi: token
İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/cart/<token>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/storefront/cart/{token}/bundles

Karşılaştırmaya ürün ekle (CAP=4; owner başına). Ürün yoksa 404; liste dolu → 409; tekrar → idempotent.

OturumYol parametresi: token
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/cart/<token>/bundles" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/storefront/cart/{token}/byob

**BYOB kutusunu sepete ekle.** Kurallar SUNUCUDA doğrulanır: adet aralığı ve izinli

OturumYol parametresi: token

koleksiyon. İstemcinin gönderdiğine güvenmek, kural dışı kutunun kutu fiyatına satılması demektir.

İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/cart/<token>/byob" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/storefront/cart/{token}/discount

Apply discount

OturumYol parametresi: token
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/cart/<token>/discount" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/shop/v1/storefront/cart/{token}/discount

Remove discount

OturumYol parametresi: token
İstek
curl -X DELETE "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/cart/<token>/discount" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/storefront/cart/{token}/items

Karşılaştırmaya ürün ekle (CAP=4; owner başına). Ürün yoksa 404; liste dolu → 409; tekrar → idempotent.

OturumYol parametresi: token
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/cart/<token>/items" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
DELETE/api/shop/v1/storefront/cart/{token}/items/{item_id}

Remove

OturumYol parametresi: tokenitem_id
İstek
curl -X DELETE "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/cart/<token>/items/<item_id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
PATCH/api/shop/v1/storefront/cart/{token}/items/{item_id}

Update item

OturumYol parametresi: tokenitem_id
İstek
curl -X PATCH "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/cart/<token>/items/<item_id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/storefront/cart/{token}/merge

Giriş sonrası guest listelerini müşteriye bağla (guest_token → customer_ref). Taşınan liste sayısı.

OturumYol parametresi: token
İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/cart/<token>/merge" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/shop/v1/storefront/cart/{token}/summary

Ürün yorum-özeti: onaylı yorumların ortalama + yıldız-dağılımı (1-5) + doğrulanmış-satın-alma sayısı

OturumYol parametresi: token

(BLE-5307 rating agregasyonu). Storefront (public).

İstek
curl -X GET "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/cart/<token>/summary" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/shop/v1/storefront/cart/discounts/preview

BLE-5057 · storefront kupon-önizleme (DRY-RUN): sepet-özeti verilen kodla hesaplanır —

Oturum

used_count/per-customer sayaçları TÜKETİLMEZ, sipariş oluşmaz (cart_summary reuse).

İstek
curl -X POST "https://{slug}.shop.blesyum.app/api/shop/v1/storefront/cart/discounts/preview" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?
Hâlâ takıldın mı? Destek al