Yanıtın yapısı
| Grup | İçerik | Yüklemede |
|---|---|---|
| baseAttributes | Her üründe bulunan temel alanlar | Yükleme dosyasında zaten doldurulur |
| attributes | Kategoriye özgü özellikler | Zorunlu olanlar doldurulur |
| variantAttributes | Varyantları birbirinden ayıran özellikler | Varyantlı üründe doldurulur |
Her özellikte bir ad, bir tür ve zorunluluk bilgisi bulunur. Tür liste tipiyse (enum) değer serbest yazılamaz; izin verilen değerlerden biri seçilir. Diğer türlerde değer serbest metin ya da sayı olarak girilir.
Listelerde ürün adı (UrunAdi), açıklama (UrunAciklamasi), barkod (Barcode), marka (Marka), garanti (GarantiSuresi), KDV (tax_vat_rate) ve görseller (Image1, Image2…) gibi temel alanlar da görünür. Bunlar yükleme dosyasında ayrıca doldurulduğu için satıcıya "özellik" olarak sorulmaz.
Liste tipi özelliklerin değerleri
Değer listesi ayrı bir uçtan, sayfalı olarak gelir: GET /product/api/categories/KATEGORI_ID/attribute/OZELLIK_ID/values.
| Parametre | Örnek | Not |
|---|---|---|
| page | 0 | 0'dan başlar |
| size | 1000 | En geniş listeler için tek seferde yeterli oldu |
| version | 1 | Canlıda bu değerle çalıştı |
Yanıttaki data dizisinin her öğesinde bir kimlik (id) ve bir metin (value) bulunur. Renk gibi uzun listelerde bile bin kayıtlık tek istek canlıda yetti. Yine de last alanını kontrol etmek güvenli yoldur.
Yükleme dosyasına nasıl yazılır?
Ürün yükleme dosyasında özellikler attributes nesnesine anahtar ve değer çifti olarak yazılır. Anahtar özelliğin adıdır. Değer, liste tipi özelliklerde seçilen değerin metnidir, kimliği değil.
- Anahtar: özelliğin adı (yanıttaki name alanı).
- Değer: seçilen değerin metni (values yanıtındaki value alanı).
- Serbest özelliklerde: ürüne ait metin ya da sayı.
Kimliği değer olarak yazmak en sık hatadır. Dosya kabul edilse bile ürün incelemede eksik ya da hatalı özellik nedeniyle geri dönebilir. Yükleme dosyasının tamamı ürün yükleme sayfasında.
Zorunlu özellikler
Zorunlu özellik doldurulmadan gönderilen ürün reddedilebilir. Doldurma stratejisini baştan belirleyin:
- Satıcının ürünü en iyi bildiği özellikleri (malzeme, renk, uyumlu model gibi) elle seçtirin.
- Varsayılan değerle otomatik doldurma pratik ama risklidir; listedeki ilk değer çoğu zaman ürüne uymaz.
- Varyant özelliklerini (renk, beden) her varyantta ayrı doldurun. Aynı değeri taşıyan iki varyant birbirinden ayrılamaz.
- Kategori değişirse özellikleri baştan çekin. Özellik seti kategoriye bağlıdır.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Özellik değeri tanınmıyor | Değer kimliği yazılmış | Değerin metnini yazın |
| Ürün eksik özellikle reddedildi | Zorunlu özellik boş | Zorunluları yanıttan okuyup doldurun |
| Renk listesi eksik geliyor | Değerler tek sayfa sanılmış | size ve last alanıyla sayfalayın |
| Temel alanlar iki kez yazılmış | baseAttributes özellik gibi işlenmiş | Temel alanları yükleme dosyasında bir kez doldurun |
Sık sorulanlar
Hepsiburada zorunlu özellikleri nasıl öğrenirim?
Kategori kimliğiyle attributes ucunu çağırın. Her özellikte zorunluluk bilgisi yer alır.
Özellik değerine kimlik mi metin mi yazılır?
Metin. Liste tipi özelliklerde values yanıtındaki value alanını yazın.
variantAttributes ne işe yarar?
Aynı ürünün varyantlarını ayıran özellikleri listeler; renk ve beden gibi. Varyantlı üründe her varyant bu özelliklerde farklı değer taşır.
Değer listesi kaç sayfa olur?
Canlıda en geniş listeler bile 1000 kayıtlık tek istekte geldi. Yine de last alanını kontrol edin.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı