Sepetler

/api/v1/sepetler — PUT

PUT/api/v1/sepetler

Sepetleri toplu yaz

dis_id’ye göre upsert. İçeriği değişmeyen sepet yazılmaz (terk süresi işlemeye devam eder); kalemler: [] sepeti siler. Kalemi olan sepette müşterinin e-postası ya da telefonu zorunludur. Siparişe dönmüş sepetin kimliği tekrar kullanılamaz (skipped_converted): her sepet örneği için yeni bir dis_id üretin.

• Kimlik doğrulama: Authorization: Bearer rz_live_…
• Kapsam: ingest:carts
• Paket özelliği: Veri API + Sepetler — kapalıysa uç 404 not_found döner
• Idempotency-Key: isteğe bağlı (tekrar denemeler için önerilir)

İstek gövdesi (application/json)

• ile işaretli alanlar zorunludur. Bilinmeyen alan 422 ile reddedilir.

CartBatch

Alan	Tür	Sınır	Anlamı
items *	ApiCart[]	en az 1, en çok 1000	1–1000 kayıt.

ApiCart

Alan	Tür	Sınır	Anlamı
dis_id *	string	min 1, max 200	Sepet örneğinin kimliği (müşterinin değil).
musteri *	ApiCartCustomer		Müşteri.
kalemler	ApiCartItem[]	en çok 200, varsayılan []	Kalemler; boş liste sepeti siler.
tutar	number | string | null	≥ 0, ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$	Sepet tutarı.
para_birimi	string	min 3, max 3, varsayılan "TRY"	Para birimi.
url	string | null	max 2000	Sepet adresi.
son_guncelleme	string (date-time) | null		Son güncelleme (terk süresi buna göre).

ApiCartCustomer

Alan	Tür	Sınır	Anlamı
ad	string | null	max 200	Ad.
eposta	string | null	max 200	E-posta.
telefon	string | null	max 32	Telefon.
dis_id	string | null	max 200	Müşteri kimliği.

ApiCartItem

Alan	Tür	Sınır	Anlamı
item_ref *	string	min 1, max 200	Ürün kimliği.
ad *	string	min 1, max 500	Ürün adı.
adet	integer	≥ 1, ≤ 999, varsayılan 1	Adet.
birim_fiyat *	number | string	≥ 0, ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$	Birim fiyat.
url	string | null	max 2000	Ürün adresi.

Örnek

curl -s -X PUT "$RZ_API/api/v1/sepetler" \
  -H "Authorization: Bearer $RZ_KEY" -H "Content-Type: application/json" \
  -d '{"items": [{"dis_id": "sepet-7f3a9c",
        "musteri": {"ad": "Ayşe Yılmaz", "eposta": "[email protected]", "telefon": "05321234567"},
        "kalemler": [{"item_ref": "1234", "ad": "Kablosuz Kulaklık X2", "adet": 1, "birim_fiyat": "1899.90"}],
        "url": "https://magaza.example.com/sepet"}]}'

Yanıt 200

Şema: CartResultOut

Alan	Tür	Sınır	Anlamı
inserted *	integer
updated *	integer
unchanged *	integer
deleted *	integer
skipped_converted *	integer

{
  "inserted": 1,
  "updated": 0,
  "unchanged": 0,
  "deleted": 0,
  "skipped_converted": 0
}

Hata durumları: 401, 403, 404, 413, 422, 429 — bkz. Hatalar ve sınırlar.

---

/api/v1/sepetler — GET

GET/api/v1/sepetler

Sepetleri listele

Son güncellemeye göre yeniden eskiye. Terk edilenler için durum=terk. Müşteri telefonu maskelidir; firma Veri API’de kişisel veriyi açtıysa tam numara döner.

• Kimlik doğrulama: Authorization: Bearer rz_live_…
• Kapsam: read:carts
• Paket özelliği: Veri API + Sepetler — kapalıysa uç 404 not_found döner

Parametreler

Ad	Yer	Tür	Sınır	Anlamı
durum	query	string | null		Durum süzgeci: sepette ör. terk; fırsatta yeni, iletisimde, teklif, kazanildi, kaybedildi.
cursor	query	string | null		Önceki yanıttaki next_cursor.
limit	query	integer	≥ 1, ≤ 100, varsayılan 50	Sayfa boyutu.

Örnek

curl -s -G "$RZ_API/api/v1/sepetler" -H "Authorization: Bearer $RZ_KEY" --data-urlencode "durum=terk"

Yanıt 200

{
  "items": [
    {
      "dis_id": "sepet-7f3a9c",
      "kalemler": [
        {
          "item_ref": "1234",
          "ad": "Kablosuz Kulaklık X2",
          "adet": 1,
          "birim_fiyat": "1899.90"
        }
      ],
      "tutar": "1899.90",
      "para_birimi": "TRY",
      "url": "https://magaza.example.com/sepet",
      "durum": "terk",
      "son_guncelleme": "2026-09-24T09:00:00Z",
      "siparis_no": null,
      "musteri": {
        "ad": "Ayşe Yılmaz",
        "eposta": "[email protected]",
        "telefon": "+90 532 *** ** 67"
      }
    }
  ],
  "next_cursor": null
}

Hata durumları: 401, 403, 404, 413, 422, 429 — bkz. Hatalar ve sınırlar.

---

/api/v1/sepetler/{dis_id} — DELETE

DELETE/api/v1/sepetler/{dis_id}

Sepeti sil

Sepeti siler. Kayıt yoksa 404 not_found.

• Kimlik doğrulama: Authorization: Bearer rz_live_…
• Kapsam: ingest:carts
• Paket özelliği: Veri API + Sepetler — kapalıysa uç 404 not_found döner
• Idempotency-Key: isteğe bağlı (tekrar denemeler için önerilir)

Parametreler

Ad	Yer	Tür	Sınır	Anlamı
dis_id *	path	string		Sizin sisteminizdeki kimlik.

Örnek

curl -s -X DELETE "$RZ_API/api/v1/sepetler/sepet-7f3a9c" -H "Authorization: Bearer $RZ_KEY"

Yanıt 200

{
  "deleted": 1
}

Hata durumları: 401, 403, 404, 413, 422, 429 — bkz. Hatalar ve sınırlar.