İstek ve yanıt
| Alan | Yön | Anlamı | Örnek |
|---|---|---|---|
| offset | İstek | Kaçıncı kayıttan başlanacağı | 0 |
| limit | İstek | Sayfa boyutu | 100 |
| listings | Yanıt | Listeleme satırları | dizi |
| totalCount | Yanıt | Toplam listeleme sayısı | 1250 |
| limit, offset | Yanıt | İsteğin yankısı | 100, 0 |
İlk istek offset=0 ile yapılır. Sonraki her istekte offset limit kadar artırılır. Gelen satır sayısı limitten azsa son sayfadasınız. Bu uca tek kayıtlık bir istek (limit=1) atmak, kimlik bilgilerini sınamanın da en ucuz yoludur.
Satırdaki alanlar
Aşağıdaki alanlar canlı yanıtlarda görüldü. Anlamları alan adlarından ve kullanımdan çıkarılmıştır; kesin tanım için resmî dokümana bakın.
| Alan | Anlamı |
|---|---|
| hepsiburadaSku | Hepsiburada SKU'su; stok ve fiyat yüklemesinde kullanılır |
| merchantSku | Satıcı stok kodu |
| price | Satış fiyatı |
| listPrice | Liste fiyatı |
| availableStock | Satılabilir stok |
| dispatchTime | Kargoya hazırlık süresi |
| listingStatus | Listeleme durumu |
| isSalable | Listelemenin satışa açık olup olmadığı |
| productId | Katalog ürününün kimliği |
Ürün adı ve görsel bu listede beklenmemelidir; canlı yanıtlarda bu alanlar görülmedi. Bu bilgiler için mağaza ürün listesi kullanılır.
Stok alanını güvenle okumak
Hepsiburada'da gerçek stoğun kaynağı bu listedir. Yine de alanı okurken iki kurala uyun:
- Alan yoksa ya da sayı değilse stoğu "bilinmiyor" sayın. Boşluğu sıfır diye yorumlamak, satıştaki ürünü kendi kaydınızda tükenmiş gösterir.
- Negatif ya da ondalıklı değer gelirse sıfırın altına inmeyen bir tam sayıya çevirin.
Stoğu bilinmeyen bir ürün için kendi kaydınızdaki eski değeri koruyun. Bir sonraki okumada değer gelirse güncellersiniz. Bu küçük kural, bir sayfanın eksik dönmesi gibi geçici sorunlarda yüzlerce ürünün yanlışlıkla sıfırlanmasını önler.
Listeyi eşleme haritasına çevirmek
Listing listesi yalnız stok için değil, kimlik eşlemesi için de gereklidir. Katalog servisi bazı ürünlerde Hepsiburada SKU'sunu vermediği için doğru SKU bu listeden bulunur.
- Satıcı stok kodundan Hepsiburada SKU'suna giden bir harita kurun.
- Satıcı stok kodundan ve barkoddan stoğa giden ikinci bir harita kurun.
- Haritaları her senkronda baştan kurun; Hepsiburada SKU'su zamanla değişebilir.
- Listeye erişilemezse eski haritayla devam edin ama stok yazmayın.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Liste hep ilk 100 kayıtta kalıyor | offset artırılmıyor | Her turda offset değerini limit kadar artırın |
| Ürün adları boş | Ad bu listeden okunuyor | Adı MPOP mağaza ürün listesinden alın |
| Bazı ürünler sıfır stokta görünüyor | Eksik stok alanı sıfır sayılmış | Eksik alanı bilinmiyor sayın |
| 400 "Merchant ID is not specified." | Yoldaki kimlik tanınmadı | Merchant ID'yi kontrol edin |
Sık sorulanlar
Hepsiburada listing API ucu nedir?
Listing servisinde GET /listings/merchantid/SATICI_ID. offset ve limit ile sayfalanır.
Listing ile katalog ürünü arasındaki fark nedir?
Katalog ürünü ortak kayıttır; ad, görsel ve özellik orada durur. Listeleme sizin satış teklifinizdir; fiyat ve stok burada tutulur.
Listing yanıtında ürün adı neden yok?
Bu uç satış teklifini döndürür, ürün içeriğini değil. Ad ve görseli MPOP mağaza ürün listesinden alın.
Gerçek stoğu hangi alandan okurum?
availableStock alanından. Alan yoksa stoğu bilinmiyor sayın ve eski değeri koruyun.
Kimlik bilgilerimi bu uçla test edebilir miyim?
Evet. limit=1 ile yapılan bir istek 200 dönüyorsa Basic başlığı ve User-Agent doğrudur.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı