Shopify API sürümleri: ERP, kargo ve fatura entegrasyonunuz neden bir gün hata vermeden bozulur?
Shopify üç ayda bir yeni API sürümü yayımlıyor ve her sürümü en az 12 ay destekliyor. Süresi dolan sürümü isteyen bir entegrasyon hata almıyor; Shopify ona desteklenen en eski sürümle yanıt veriyor. Bu yüzden kaldırılan bir alan, bir gün siparişin ERP'ye eksik düşmesi olarak ortaya çıkabiliyor. Takvimi, uyarıların kime gittiğini ve mağaza sahibinin bakması gerekenleri yazdık.
Mağazanızı ERP'ye, kargo firmasına ya da e-fatura sağlayıcısına bağlayan entegrasyon Shopify ile Admin API üzerinden konuşuyor. Bu API'nin tek bir sabit hali yok. Shopify her çeyreğin ilk günü yeni bir sürüm yayımlıyor ve eski sürümleri belli bir süre sonra kullanımdan kaldırıyor. Entegrasyon yazıldığı günkü sürümde kalırsa bir noktada desteklenmeyen bir sürümü istemeye başlıyor.
Bu durum panelde bir hata mesajı olarak görünmüyor. Mağaza çalışıyor, siparişler geliyor; bozulma, ERP'ye düşen siparişte bir alanın boş kalması ya da stok eşitlemesinin bir gün durması gibi dolaylı yollardan fark ediliyor.
Takvim: üç ayda bir yeni sürüm, en az 12 ay destek
Shopify'ın geliştirici belgesine göre yeni API sürümü her çeyreğin ilk günü UTC ile saat 17:00'de yayımlanıyor. Sürümlerin adı tarihten geliyor: 2026-04, 2026-07, 2026-10 gibi. Kasım 2026 itibarıyla REST Admin API başvuru sayfasında görünen en yeni sürüm 2026-10.
Süresi dolan sürümde ne oluyor?
Entegrasyon artık desteklenmeyen bir sürümü istediğinde Shopify isteği reddetmiyor. Belgedeki ifadeyle istek, erişilebilen en eski kararlı sürüme “ileri düşüyor” ve yanıt o sürümle veriliyor. Belgenin örneğinde kaldırılmış 2024-10 sürümünü isteyen bir uygulama, desteklenen en eski sürümün yanıtını alıyor.
Entegrasyon bu yüzden hata almadan çalışmaya devam ediyor, ama yazıldığı sürümden farklı bir yanıtla. Aradaki sürümlerde adı değişen ya da kaldırılan bir alan varsa, entegrasyon o alanı bulamıyor. Kodun bu durumu nasıl ele aldığına göre sonuç değişiyor: alan boş geçiliyor, kayıt atlanıyor ya da işlem yarıda kalıyor.
Shopify her yanıta X-Shopify-API-Version başlığını ekliyor ve bu başlık isteği karşılayan sürümü gösteriyor. Başlıktaki sürüm entegrasyonun istediğinden farklıysa istek ileri düşmüş demektir. Entegrasyonun kayıtlarında bu başlık tutuluyorsa sorun ortaya çıkmadan görülebiliyor.
Uyarılar kime gidiyor?
Shopify kullanımdan kalkan çağrılar için uyarıyı uygulamanın geliştiricisine veriyor: geliştirici panelindeki (Dev Dashboard) uyarılar, GraphiQL Explorer'daki uyarılar, geliştirici değişiklik günlüğü ve API başvuru sayfaları. Yakın zamanda geriye uyumsuz bir değişiklik varsa uygulamanın acil durum geliştirici iletişim adresine de bildirim gidiyor.
Belgede sayılan kanalların hiçbiri mağaza paneli değil. Entegrasyonu yazan yazılım firmasıyla çalışmayı bıraktıysanız ya da uygulama eski ajansın geliştirici hesabında duruyorsa, uyarılar artık kimsenin okumadığı bir hesaba gidiyor olabilir. Entegrasyonun geliştirici hesabının kimde olduğunu ve acil durum adresinin bugün kime ait olduğunu bilmek bu yüzden bakımın parçası.
REST Admin API ve yeni uygulamalar
Shopify REST Admin API'yi 1 Ekim 2024'te legacy (eski) olarak işaretledi. 1 Nisan 2025'ten beri Shopify App Store'a gönderilen yeni herkese açık uygulamaların yalnızca GraphQL Admin API ile yazılması gerekiyor. REST başvuru sayfası mevcut uygulamalar için bir kapanış tarihi vermiyor.
Mağazaya özel yazılmış bir entegrasyon REST kullanıyorsa bugün çalışmaya devam ediyor. REST legacy durumda olduğu için, entegrasyona yeni bir alan ya da işlem eklenecek bir güncelleme planlarken GraphQL'e geçişi de sormakta yarar var.
Panelden açılan özel uygulamalar
Bir ERP ya da fatura bağlantısı, mağaza panelinde açılmış bir özel uygulamanın erişim anahtarıyla da çalışıyor olabilir. Shopify 1 Ocak 2026'dan beri panelden yeni özel uygulama açılmasına izin vermiyor. Yeni bir özel uygulama artık geliştirici panelinde (Dev Dashboard) oluşturulup mağazaya kuruluyor. Shopify, mevcut özel uygulamaların bu değişiklikten etkilenmediğini ve çalışmaya devam ettiğini yazıyor.
Panelden açılmış özel uygulamaların erişim anahtarı yalnızca oluşturulduğu anda bir kez gösteriliyor. Anahtar kaybolursa ya da sızdığı düşünülürse yenisini almak için uygulamayı kaldırıp yeniden kurmak gerekiyor.
Özel uygulamanın yapım maliyetini, bakım kalemini ve hazır uygulamayla karşılaştırmasını ayrı bir yazıda anlattık.
Özel uygulama yazısıMağaza sahibinin bakması gerekenler
Mağazanıza bağlı özel uygulamaların ve entegrasyonların hangi API sürümünü kullandığını, kimin hesabında durduğunu ve ne zaman güncellenmesi gerektiğini çıkarıyor, güncellemeyi bakım takvimine bağlıyoruz.
Bakım ve destekKaynaklar
- Shopify geliştirici belgeleri, About Shopify API versioning: çeyrek başında yayın, en az 12 ay destek ve dokuz ay örtüşme, sürüm adayı ve unstable, desteklenmeyen sürümde ileri düşme, X-Shopify-API-Version başlığı, kullanımdan kalkma bildirimlerinin kanalları, her çeyrek güncelleme önerisi
- Shopify geliştirici belgeleri, REST Admin API reference: 1 Ekim 2024 itibarıyla legacy, 1 Nisan 2025'ten beri yeni herkese açık uygulamalar için GraphQL zorunluluğu, en yeni sürüm 2026-10
- Shopify geliştirici değişiklik günlüğü, Legacy custom apps can't be created after January 1, 2026 (30 Ekim 2025): panelden yeni özel uygulama açılamaması, mevcut uygulamaların çalışmaya devam etmesi, Dev Dashboard yolu
- Shopify geliştirici belgeleri, Generate access tokens for admin-created custom apps: erişim anahtarının bir kez gösterilmesi, kaldırıp yeniden kurarak yenileme, yeni uygulamalar için Dev Dashboard
