Ekim 2026 itibarıyla sürüm tablosu
Aşağıdaki tablo Shopify’ın sürüm belgesindeki takvimden alındı. Erişim bitiş saatleri UTC’dir.
| Sürüm | Yayın | Erişilebilir olduğu son tarih | Durum |
|---|---|---|---|
| 2025-10 | 1 Ekim 2025 | 16 Ekim 2026 | Desteklenmiyor |
| 2026-01 | 1 Ocak 2026 | 16 Ocak 2027 | Kararlı |
| 2026-04 | 1 Nisan 2026 | 16 Nisan 2027 | Kararlı |
| 2026-07 | 1 Temmuz 2026 | 16 Temmuz 2027 | Kararlı |
| 2026-10 | 1 Ekim 2026 | 16 Ekim 2027 | En güncel kararlı |
| 2027-01 | 1 Ocak 2027 | 16 Ocak 2028 | Sürüm adayı |
Takvim her çeyrekte kayar. Bu tabloya göre 2025-10 ve daha eski sürümleri hedefleyen istekler artık 2026-01 ile yanıtlanır. Güncel durumu Shopify sürüm belgesinden kontrol edin.
Sürüm türleri
| Tür | Ne zaman kullanılır |
|---|---|
| Kararlı (stable) | Canlı kullanım; destek süresi boyunca değişmez |
| Sürüm adayı (release candidate) | Erken test; geriye uyumsuz değişiklik içerebilir |
| Kararsız (unstable) | Yalnız deneme; özellikler her an eklenip çıkarılabilir |
Sürüm adresin içinde yazılır: /admin/api/2026-10/graphql.json ya da /admin/api/2026-10/products.json. Shopify her çeyrekte en güncel kararlı sürüme geçmenizi ve isteklerde sürümü her zaman açıkça belirtmenizi önerir.
Eski sürüm isterseniz ne olur?
Erişilemeyen bir sürümü hedefleyen istek hata almaz; Shopify onu erişilebilir en eski kararlı sürümle yanıtlar. Belgedeki örnek tam da budur: emekliye ayrılmış 2024-10’u isteyen çağrı, erişilebilir en eski kararlı sürümle karşılanır.
- Yanıttaki X-Shopify-API-Version başlığı kullanılan sürümü gösterir.
- Bu değer istediğinizden farklıysa uygulamanız erişilemeyen bir sürümü hedefliyor demektir.
- Bu durumda alan adları ve davranışlar beklediğinizden farklı olabilir; sessiz hatalara yol açabilir.
Webhook gövdeleri de aynı şekilde sürümlüdür ve X-Shopify-Api-Version başlığı taşır. Webhook sürümü abonelik başına değil, uygulama yapılandırmasında belirlenir.
Kullanımdan kaldırma nasıl duyurulur?
Bir alan ya da API kullanımdan kaldırıldığında bu, desteklenen tüm kararlı sürümlerde işaretlenir ve geliştirici değişiklik günlüğünde duyurulur. Kaldırılan öğe sonraki bir sürümde silinebilir; sürümler en az dokuz ay örtüştüğü için geçiş süresi tanınır.
- Dev Dashboard’daki uygulama uyarıları kullanımdan kalkmış çağrıları ve son tarihi gösterir.
- GraphiQL gibi araçlar uyarı verir.
- Yakın tarihli geriye uyumsuz değişikliklerde uygulamanın acil durum iletişim kişisine haber verilebilir.
Bütün bir API de kullanımdan kalkabilir; böyle bir API çalışmaya devam etse bile desteklenmez ve her an durabilir.
Sık sorulanlar
Shopify’ın güncel API sürümü hangisi?
27 Ekim 2026 itibarıyla en güncel kararlı sürüm 2026-10’dur. 2027-01 sürüm adayı olarak yayındadır.
Bir Shopify API sürümü ne kadar desteklenir?
Her kararlı sürüm en az 12 ay desteklenir; ardışık sürümler en az dokuz ay örtüşür.
Desteklenmeyen sürümle istek gönderirsem hata alır mıyım?
Hayır. Shopify isteği erişilebilir en eski kararlı sürümle yanıtlar. Kullanılan sürümü X-Shopify-API-Version başlığından görürsünüz.
Webhook’ların sürümü nasıl belirlenir?
Uygulamanın yapılandırmasındaki Webhooks API sürümüyle. Abonelik başına ayrı sürüm seçilemez.
Sürümü ne sıklıkla güncellemeliyim?
Shopify her çeyrekte en güncel kararlı sürüme geçmeyi önerir. En azından kullandığınız sürümün erişim bitiş tarihini takvime yazın ve sürüm notlarındaki işlem gerektiren değişiklikleri o tarihten önce uygulayın.
Kaynaklar
İlgili Shopify API konuları
Son güncelleme: 27.10.2026 · Shopify API rehberinin tamamı