Özellik listesindeki alanlar
| Alan | Anlamı |
|---|---|
| attribute.id / attribute.name | Özelliğin kimliği ve adı (Beden, Renk, Cinsiyet gibi) |
| required | true ise ürün gönderirken bu özellik zorunludur |
| allowCustom | true ise değer kimliği yerine serbest metin gönderilir |
| allowMultipleAttributeValues | true ise birden çok değer seçilebilir |
| slicer | true ise trendyol.com'da ayrı ürün kartı açılır |
| varianter | true ise özellik aynı kartta varyant seçeneği olur |
Servis required filtresi alır: required=true yalnız zorunlu, required=false yalnız zorunlu olmayan özellikleri döndürür. Kategori ID'si mutlaka en alt seviye kategori olmalıdır.
Özellik değerlerini almak
Değer listesi ayrı ve sayfalı bir servistir. Yanıt totalElements, totalPages, page, size ve content döner; her elemanda attributeValueId ve attributeValue bulunur. size ve page en fazla 1000 değerini alabilir.
Değerleri her ürün gönderiminde yeniden çekmeyin. Trendyol listeleri haftalık yenilemenizi önerir; arada önbellekten kullanmak hem hızlıdır hem de Product Integration Read limitini korur.
V1'deki eski özellik servisi değerleri özellik listesiyle birlikte tek yanıtta veriyordu. V2'de bu iki adım ayrıldı. Kodunuz eski yanıt yapısını bekliyorsa, önce özellik listesini alıp ardından ihtiyaç duyduğunuz her özellik için değer servisini çağıracak biçimde güncelleyin.
Ürüne özellik nasıl yazılır?
createProducts v2 isteğindeki attributes dizisinde her eleman bir özelliktir:
- Liste değeri: attributeId: 293, attributeValueIds: [4872]
- Çoklu değer (allowMultipleAttributeValues true): attributeId ile birden çok kimlik içeren attributeValueIds dizisi
- Serbest metin (allowCustom true): attributeId: 47, attributeValue: Lacivert
V1'deki attributeValueId ve customAttributeValue alan adları v2 şemasında yoktur. Eski koddan taşınan isteklerde bu adları değiştirin. Renk bilgisi 50 karakterden uzun olamaz.
Menşei bilgisi
Menşei şu an iki yerde tanımlanabiliyor: kategori özelliği olarak ve ürün gövdesindeki iki harfli origin alanıyla (örneğin TR). Trendyol, origin alanını 23 Ekim 2026'da zorunlu yapma planını ertelediğini duyurdu. Yeni bir duyuru yapılana kadar menşei bilgisinin özellikler (attribute) altından gönderilmesi zorunlu kalıyor.
Geçerli ülke kodlarının listesi resmî dokümanın menşei değerleri sayfasındadır. Kodlar iki harflidir; örneğin TR Türkiye, AZ Azerbaycan, BE Belçika anlamına gelir. Onaylı ve onaysız ürün filtrelerinde origin parametresiyle bu kodlara göre arama da yapılabilir.
Sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| Zorunlu özellik eksik hatası | required true olan özellik gönderilmedi | required=true filtresiyle listeyi alıp hepsini doldurun |
| Değer kabul edilmiyor | allowCustom false olan özelliğe metin yazıldı | Değer listesinden attributeValueId seçin |
| Çoklu değer reddediliyor | allowMultipleAttributeValues false | Tek değer gönderin |
| Eski değer kimliği geçersiz | Liste güncellendi | Değerleri yeniden çekin |
Sık sorulanlar
Trendyol'da zorunlu özellikleri nasıl öğrenirim?
Kategori özellik servisini required=true ile çağırın. Dönen her özellik ürün gönderirken attributes dizisinde bulunmalıdır.
allowCustom true ne demek?
Bu özellik için değer kimliği yerine serbest metin gönderilir. Metin, attributes dizisinde attributeValue alanına yazılır.
Slicer ile varianter farkı nedir?
Slicer özellik (çoğunlukla renk) ürünü ayrı kartlarda açar. Varianter özellik (çoğunlukla beden) aynı kart içinde seçenek oluşturur. Her kategoride en fazla bir varianter olur.
Menşei bilgisini nereye yazmalıyım?
Trendyol'un Ekim 2026 duyurusuna göre yeni bir tarih açıklanana kadar menşei bilgisinin attribute altından gönderilmesi zorunludur. Ürün gövdesindeki origin alanı şimdilik isteğe bağlıdır.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı