Ürün arama API rehberi

Bu rehber sitenin kendi kullandığı herkese açık JSON ürün arama servisini açıklar. Sürümlenmiş bir entegrasyon sözleşmesi değildir ve ortak kodu almaz; kalıcı entegrasyon ve ortak bağlantılı ürün adresleri için XML ortak API’sini (ref parametresiyle) kullanın.

Ürün arama

İstek biçimi

YöntemGETİstek adresi/api/products?q=...

Sorgu parametreleri

Ad	Açıklama
`q`	Ürün başlığında arama; en fazla 100 karakter.
`category`	Kategori adresi; alt kategoriler de dahil edilir.
`sort`	newest, price_asc veya price_desc.
`inStock`	1 değeri stoklu ilanları filtreler.
`minPrice / maxPrice`	TRY cinsinden kuruş olarak alt ve üst fiyat.
`cursor`	Önceki yanıttaki nextCursor; aynı filtrelerle kullanılır.
`includeTotal`	false değeri toplam sayma sorgusunu atlar.

Yanıt biçimi

En fazla 24 aktif ilan, toplam (istenirse) ve sonraki sayfa için nextCursor döner. İlan stoğu bir rezervasyon veya satın alma garantisi değildir.

{
  "items": [...],
  "total": null,
  "nextCursor": null
}

Ad	Açıklama
`items`	Bu sayfadaki herkese açık ilanlar; başlık, fiyat, stok, satıcı ve kategori bilgilerini içerir.
`total`	Eşleşen ilan sayısı; includeTotal=false ise null.
`pageSize`	Sayfada döndürülen en fazla ilan sayısı.
`nextCursor`	Sonraki sayfanın imleci; başka sonuç yoksa null.