Katalog Varyantları

Teklif açabileceğiniz ürün varyantlarını listeler.

GET/v1/catalog-variantsscope:CatalogRead

Yetkilendirme

Bu endpoint CatalogRead 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
`productId`	string(32)	Tek bir ürünün varyantları
`sku`	string	SKU ile arama
`variantName`	string	Varyant adı ile arama
`isActive`	boolean	Yalnızca aktif ya da pasif varyantlar

orderBy şu alanlardan biri olabilir: CreatedAt, Sku, VariantName, IsActive.

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": "019df3015c5b7eb9b14196dd5d53d9ec",
    "productId": "019df2fefea479e7b61e80e19554e4b7",
    "sku": "325-PUBG-MOBILE-UC-T2WH",
    "variantName": "300+25 PUBG Mobile UC",
    "imageUrl": "catalog-images/variants/019df301.../325-pubg-mobile-uc.jpg",
    "thumbnailUrl": "catalog-images/variants/019df301.../thumbs/..._thumb.webp",
    "isActive": true,
    "createdAt": "2026-05-05T09:14:02.113456+00:00"
  }
]

Alanlar

Alan	Tip	Açıklama
`id`	string	Varyant kimliği — teklif oluştururken `variantId` olarak kullanılır
`productId`	string	Varyantın bağlı olduğu ürün
`sku`	string	Varyantın stok kodu
`variantName`	string	Varyant adı
`imageUrl`	string	Görsel yolu; her varyantta bulunmayabilir
`thumbnailUrl`	string	Küçük görsel yolu
`isActive`	boolean	Pasif varyantlara yeni teklif açılamaz
`createdAt`	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ı