dotCREA
TREN
Bakım & Destek

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.

Her kararlı sürüm en az 12 ay destekleniyor. Art arda gelen iki sürüm en az dokuz ay boyunca birlikte geçerli kalıyor.
Kararlı sürüm, desteklendiği süre boyunca değişmiyor. Aynı sürümde kalan bir entegrasyon, o sürüm desteklendiği sürece Shopify tarafındaki bir değişiklikten etkilenmiyor.
Kararlı sürümle aynı gün bir sürüm adayı (release candidate) ve sürekli değişen bir unstable sürüm de yayımlanıyor. Shopify ikisini de canlı mağazada kullanılmak için önermiyor.
Shopify'ın önerisi, her çeyrek en yeni kararlı sürüme geçmek ve her istekte sürümü açıkça belirtmek.

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.

İlgili yazı
Özel uygulama ne zaman gerekir?

Ö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

Ayarlar > Uygulamalar ekranındaki özel uygulamaları ve mağazaya veri yazan entegrasyonları listeleyin. Her birinin yanına onu kimin yazdığını ve bugün kimin bakımını yaptığını not edin.
Entegrasyonu yazan firmaya hangi API sürümünü istediğini sorun. Sürümün kodda sabit yazılı olup olmadığını ve en son ne zaman güncellendiğini öğrenin.
Entegrasyon kayıtlarında X-Shopify-API-Version başlığının tutulup tutulmadığını sorun. Tutuluyorsa istenen ve yanıt veren sürümün aynı olup olmadığına bakılabilir.
Uygulamanın geliştirici hesabının ve acil durum iletişim adresinin kimde olduğunu öğrenin. Eski bir ajansta kaldıysa devralma ya da yeni bir uygulama planlayın.
API sürüm güncellemesini yılda bir kez yapılacak bir iş olarak bakım takvimine yazın. Sürümler en az 12 ay desteklendiği için bu, entegrasyonu desteklenen bir sürümde tutmanın en seyrek yolu. Shopify'ın önerdiği ise her çeyrek güncellemek.
Özel uygulamaların erişim anahtarlarının nerede saklandığını ve kimlerin eriştiğini kontrol edin.
İlgili hizmet
Entegrasyonlarınızın API sürümünü kontrol edelim

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 destek

Kaynaklar

  1. 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
  2. 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
  3. 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
  4. 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
dC
dotCREA Shopify ekibi
17 Kasım 2026 tarihinde yayımlandı
Paylaş
Bu konu mağazanızda ne durumda?
Mağaza adresinizi gönderin, ücretsiz değerlendirelim.
Teklif alın

İlgili yazılar