İki uç nokta
| v1 | v2 | |
|---|---|---|
| Adres | https://api.myikas.com/api/v1/admin/graphql | https://api.myikas.com/api/v2/admin/graphql |
| Yeni entegrasyonlar | Önerilmez | Önerilir |
| Kayıt oluşturma ve güncelleme | Tek save... işlemi | Ayrı create... ve update... işlemleri |
| Görsel yükleme | .../api/v1/admin/product/upload/image | .../api/v2/admin/upload/image |
Token ve kimlik doğrulama iki sürümde aynıdır. ikas referansında her işlemin yanında hangi sürümde bulunduğunu gösteren bir etiket vardır (ikas: v1 ve v2). Kenar çubuğundaki Tümü, v2 ve v1 seçicisi yalnız kullandığınız uç noktada çalışan işlemleri listeler.
İşlem adlarındaki değişiklikler
| v1 | v2 |
|---|---|
| saveProduct | createProduct, updateProduct |
| saveCategory | createCategory, updateCategory |
| saveProductBrand | createProductBrand, updateProductBrand |
| saveVariantPrices | updateVariantPrices |
| saveProductStockLocations | saveVariantStocks |
| saveWebhook | saveWebhooks |
| listMerchantSettings | getMerchantSettings |
v1'deki save işlemleri girdide id gönderilip gönderilmediğine göre kayıt açar ya da günceller. v2'de bu ayrım işlem adındadır; yanlışlıkla yeni kayıt açma riski azalır.
Yanıt biçimi de değişti
v1'deki stok ve fiyat işlemleri yalnız true ya da false döndürür. v2'deki toplu işlemler ise bir errors listesi döndürür: hatalı satırlar errorCode, inputArrayIndex ve gönderilen girdiyle birlikte gelir, diğer satırlar işlenir. Bu, binlerce varyantlık bir güncellemede hangi satırın neden reddedildiğini görmeyi kolaylaştırır.
v2'de marka ve kategori, ürün oluştururken adla gönderilebilir; mağazada yoksa ikas bunları kendisi oluşturur. v1'de marka ve kategori kimlikleri (brandId, categoryIds) gerekir.
Yalnız v1'de kalanlar ve geçiş
ikas'a göre tedarikçi, ürün birimi, kademeli indirim, ürün sıralama ve mağaza politikası işlemleri şu an yalnız v1'dedir; bunları kullanan entegrasyonlar v1'de kalmalıdır.
- Kullandığınız her işlemi referanstaki sürüm etiketiyle karşılaştırın.
- İzinleri kontrol edin: v2'de stok okuma read_products ile yapılır.
- v2 yanıtlarındaki errors listesini işleyecek kodu yazın; true ya da false beklemeyin.
- Görsel yükleme adresini ve v2'de zorunlu productId alanını güncelleyin.
- Geçişi önce bir test mağazasında, az sayıda ürünle deneyin.
- Geçiş süresince iki sürümü yan yana çalıştırabilirsiniz; token ortaktır, yalnız adres ve işlem adları farklıdır.
Sık sorulanlar
ikas API v1 kapanacak mı?
ikas belgelerinde v1'in mevcut entegrasyonlar için çalışmaya devam ettiği yazar; kapanış tarihi verilmez. Yeni entegrasyonlar için v2 önerilir.
Aynı token v1 ve v2'de çalışır mı?
Evet. Token alma adresi ve Bearer başlığı iki sürümde aynıdır; yalnız GraphQL adresi ve işlem adları değişir.
v2'de saveProduct neden yok?
v2'de kayıt açma ve güncelleme ayrıldı. Yeni ürün için createProduct, var olan ürünü değiştirmek için updateProduct kullanılır.
v2 entegrasyonunda yalnız v1'de olan bir işlemi kullanabilir miyim?
Evet. Token iki adreste de aynıdır; o işleme ait isteği v1 adresine göndermeniz yeterlidir. ikas da tedarikçi ya da ürün birimi gibi işlemleri kullanan entegrasyonların v1'i kullanmaya devam etmesini söyler.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı