productImage alanları
| Alan | Tip | Açıklama |
|---|---|---|
| productId | Metin | Görselin ekleneceği ürün; v2'de zorunlu |
| variantIds | Metin listesi | Zorunlu; en az 1, en fazla 50 varyant. Görsel hepsine eklenir |
| order | Sayı | Zorunlu; görselin sırası. v2'de 0 ya da daha büyük |
| isMain | Mantıksal | Ana görsel mi; varsayılan false |
| url | Metin | Görselin adresi; verilirse base64 gerekmez |
| base64 | Metin | Görselin base64 içeriği; verilirse url gerekmez |
Kaynak: ikas: Görsel yükleme.
Kurallar
- url ve base64 alanlarından tam olarak biri gönderilir; ikisi birlikte gelirse istek 400 döner.
- Bir varyant en fazla 10 görsel alabilir. 10 görseli olan varyanta yeni görsel eklenmez.
- v2'de variantIds içindeki varyantlar productId ile verilen ürüne ait olmalıdır.
- Her istekte productImage, categoryImage ve brandImage alanlarından yalnız biri bulunur. Aynı uç kategori ve marka görsellerini de yükler.
- İstek Content-Type: application/json ve Authorization: Bearer başlıklarıyla gider.
- Görseller order değerine göre sıralanır; sırayı baştan planlamak sonradan düzeltme ihtiyacını azaltır.
Adım adım
| Adım | İşlem |
|---|---|
| 1 | Ürünü açın; yanıttan ürün ve varyant kimliklerini alın |
| 2 | İlk görseli order 0 ve isMain true ile gönderin |
| 3 | Diğer görselleri artan order değerleriyle gönderin |
| 4 | Hata alan görseli kaydedin; ürün kaydını geri almayın |
Görsel adresi herkese açık olmalıdır; ikas'ın indiremediği bir adres yükleme hatası verir. Çok sayıda ürün aktarıyorsanız istekleri ardışık gönderin ve 10 saniyede 50 istek sınırını hesaba katın. v1'de görsel ve video için imzalı yükleme adresi üreten getImageUploadUrl ve getVideoUploadUrl sorguları da vardır.
Kategori ve marka görseli
Aynı uç kategori ve marka görsellerini de yükler; yalnız gövdedeki sarmal değişir. Bu görsellerde de url ile base64'ten yalnız biri gönderilir.
| Gövde | Zorunlu alan | Görsel kaynağı |
|---|---|---|
| categoryImage | categoryIds | url ya da base64 |
| brandImage | brandIds | url ya da base64 |
Sık görülen hatalar: url ve base64 birlikte gönderildiğinde 400 alınır; 10 görseli dolan varyanta yeni görsel eklenmez; v2'de varyant başka bir ürüne aitse istek reddedilir. Token süresi dolmuşsa yükleme de 401 döner.
Sık sorulanlar
ikas görsel yükleme GraphQL ile mi yapılır?
Hayır. Görsel yükleme ayrı bir REST ucudur: v2'de api/v2/admin/upload/image, v1'de api/v1/admin/product/upload/image.
ikas varyantına kaç görsel eklenebilir?
En fazla 10. Bu sayıya ulaşmış varyanta yeni görsel eklenmez.
Görseli adres yerine dosya olarak gönderebilir miyim?
Dosyayı base64'e çevirip base64 alanında gönderebilirsiniz. url ve base64 aynı istekte birlikte gönderilmez.
Aynı görsel birden fazla varyanta eklenebilir mi?
Evet. variantIds listesine en fazla 50 varyant kimliği yazılabilir; görsel listedeki tüm varyantlara eklenir.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı