Teklifleri Listele

Kendi tekliflerinizi listeler.

GET/v1/offersscope:OffersRead

Yetkilendirme

Bu endpoint OffersRead scope'u gerektirir. Bkz. İzinler.

Query parametreleri

Sayfalama zorunlu — page, pageSize, orderBy, order alanları gerekir. Detay için Sayfalama sayfasına bakın.

Parametre	Tip	Açıklama
`variantId`	string(32)	Tek bir varyantın teklifleri
`isActive`	boolean	Yalnızca aktif ya da pasif teklifler
`allowBackorder`	boolean	Ön siparişe açık teklifler

orderBy şu alanlardan biri olabilir: CreatedAt, UpdatedAt, Price, Quantity.

Yanıt formatı

200 OK ile birlikte pagination header'ları (X-Total-Count, X-Page, X-Page-Size, X-Next-Page, X-Prev-Page) döner. Body sadece kayıt dizisini içerir.

[
  {
    "id": "019e257cdeb57968a128c6c85d642cd4",
    "variantId": "019e021dec0d765aad274decc4dac815",
    "productType": "Digital",
    "price": 124.0,
    "discountedPrice": null,
    "currency": "TRY",
    "quantity": 0,
    "reservedQuantity": 0,
    "isActive": true,
    "allowBackorder": true,
    "backorderLimit": 456,
    "createdAt": "2026-05-14T07:56:41.013207+00:00",
    "updatedAt": "2026-05-15T10:37:52.925551+00:00"
  }
]

Alanlar

Alan	Tip	Açıklama
`id`	string	Teklif kimliği
`variantId`	string	Teklifin açıldığı katalog varyantı; ürün adı ve SKU için Katalog Varyantları
`productType`	string	`Physical` ya da `Digital`
`price`	decimal	Satış fiyatı
`discountedPrice`	decimal	İndirimli fiyat; yoksa boştur
`currency`	string	Para birimi
`quantity`	number	Satışa hazır stok
`reservedQuantity`	number	Sipariş için rezerve edilmiş, henüz teslim edilmemiş adet
`isActive`	boolean	Pasif teklifler mağazada görünmez
`allowBackorder`	boolean	Stok bittiğinde sipariş alınmaya devam eder
`backorderLimit`	number	Ön sipariş üst sınırı
`createdAt` / `updatedAt`	datetime	ISO 8601, UTC

Hata kodları

Code	Anlam
`400`	Sayfalama veya filtre değeri geçersiz
`401`	HMAC kimlik doğrulama hatası
`403`	Gerekli scope eksik
`429`	Hız limiti aşıldı