Genel uygulamanız halen süresi dolmayan çevrimdışı erişim tokeni tutuyorsa, 1 Ocak 2027 kesin göçüş tarihi sınırıdır. Bunu kaçırırsanız uygulamanız aynı gün Shopify App Store'dan kaldırılır ve API çağrıları 1 Nisan 2027'den itibaren HTTP 403 hatası döndürmeye başlar. Çözüm, ticari olmayan hiçbir müdahale gerektirmeyen tek seferlik sunucu tarafı token alışverişidir.
Temel çıkarımlar
- Tüm genel uygulamalar (1 Nisan 2026'den önce oluşturulanlar da dahil) 1 Ocak 2027 tarihine kadar süresi dolan çevrimdışı erişim tokenlerine geçmelidir.
- Süresi dolan çevrimdışı tokenler 60 dakikalık erişim tokeni ömrüne ve 90 günlük yenileme tokeni ömrüne sahiptir.
- Göçüş sunucu tarafı token alışverişi POST'udur, yeniden yükleme değildir. Ticari müşteriler bunu hiç görmez.
- Alışveriş mağaza başına geri döndürülemez: eski tokeni alışveriş yaptığınız anda orijinal hemen iptal edilir.
- Özel uygulamalar, ticari müşteri tarafından oluşturulan uygulamalar ve çevrimiçi erişim tokenları bu değişiklikten etkilenmez.
Arka plan: buraya nasıl geldik
Shopify 2025'in sonlarında süresi dolan çevrimdışı token desteğini yayınladı. 1 Nisan 2026'da süresi dolan tokenler tüm yeni genel uygulamalar için zorunlu hale geldi. Ardından 20 Mayıs 2026'da Shopify bu gereksinimin tüm mevcut genel uygulamalara genişletmesi, 1 Ocak 2027'yi son tarih olarak belirledi.
Motivasyon doğrudan: hiçbir zaman süresi dolmayan bir kimlik bilgisi hiçbir zaman döndürülmeyen bir kimlik bilgisidir. Sızdırılan süresi dolmayan bir token sonsuza kadar kullanışlı kalır. Yeni model her erişim tokenine 60 dakikalık bir pencere ve her kullanımda döndürülen 90 günlük bir yenileme tokeni verir.
Çalışmakta olduğum mağazalarda birkaç genel uygulama yönetiyorum. Token göçüşü kendisi uygulama başına belki iki saatlik bir iştir. Daha uzun süren kısım, yenileme döngüsünün doğru olmasını ve başarısız yenilemelerin arka plan işlerini sessizce durdurmadan ele alınmasını sağlamaktır.
Yaptırım zaman çizelgesi (27 Ekim 2026 tarihinde güncellendi)
Shopify, Ekim 2026 güvenlik güncellemesinde yaptırım programını açıkladı. Aşamalı dağıtım, ticari müşterilere hazırlanma zamanı vermeyi amaçlamıştır, ancak Shopify açıktır: 1 Ocak göçüş tarihi, erteleme süresi değildir.
| Tarih | Ne olur |
|---|---|
| 1 Nisan 2026 | Süresi dolan tokenler tüm yeni genel uygulamalar için gerekli |
| 1 Ocak 2027 | Göçüş yapılmayan uygulamalar App Store'dan kaldırılır, yeni yüklemeleri engellenir; mevcut yüklemeler hala çalışır |
| 15 Ocak 2027 | Göçüş yapılmayan uygulamaları kullanan ticari müşteriler Shopify yönetim panelinde uyarı görür |
| 1 Nisan 2027 | Süresi dolmayan çevrimdışı tokenler kullanan Admin API istekleri HTTP 403 döndürür |
Insanları çoğu kez aldatan bir nokta: Shopify'ın kendi belgelerinde bir farklılık var. Göçüş kılavuzu bazı durumlarda 403'ün 1 Ocak'ta başladığını belirtirken, 27 Ekim değişim kaydı mevcut yüklemeler için 1 Nisan'ı belirtir. Hangi olursa olsun 1 Ocak'ı gerçek son tarihiniz olarak ele alın, çünkü bu gün kaldırma gerçekleşir ve ticari müşterilere görünen uyarılar iki hafta sonra gelir.
Etkilenen ve etkilenmeyen kimler
Etkilenen:
- Süresi dolmayan çevrimdışı tokenlerle Shopify Admin API'sini çağıran genel uygulamalar (App Store'da listelenmiş veya listelenmemiş)
- 1 Nisan 2026'dan önce oluşturulan, önceden muaf olan uygulamalar
Etkilenmeyen:
- Özel uygulamalar (İş Ortağı Panelinde belirli bir mağaza için oluşturulan)
- Ticari müşteri tarafından oluşturulan uygulamalar
- Çevrimiçi erişim tokenları (bunlar zaten oturum başına süresi dolma özelliğine sahipti)
Depolanan tokenleriniz ilk OAuth yüklemesinden beri hiçbir zaman değişmediyse, süresi dolmayan tokenler çalıştırıyorsunuz ve şimdi harekete geçmeniz gerekir.
Hızlı denetim: İş Ortağı Dev Panelinde uygulamanızın Günlükleri açın, Türü "GraphQL request" olarak filtreleyin, ardından Token türünü "Offline, non-expiring" olarak filtreleyin. Orada isabet görürseniz, göçüş yapılmamıştır.
Süresi dolan çevrimdışı tokenler mekanik olarak nasıl çalışır
Erişim tokeni ömrü 60 dakikadır. Bununla birlikte gelen yenileme tokeni 90 gün geçerlidir. Yeni bir erişim tokeni almak için yenileme tokeni kullandığınızda, Shopify her ikisini de döndürür: yeni bir erişim tokeni ve yeni bir yenileme tokeni alırsınız (90 günlük saati sıfırlarsınız). Önceki erişim tokeni kendi 60 dakikalık süresi dolana kadar geçerli kalır, bu nedenle uçuşta olan istekler temiz tamamlanır.
Çok önemli: uygulama ve mağaza kombinasyonu başına yalnızca bir süresi dolan çevrimdışı token etkin olabilir. Yeni birini oluşturu mak tüm önceki olanları devre dışı bırakır. Bu, yenileme kilitleme stratejiniz için önemlidir (aşağıda ele alınmıştır).
Göçüş yolu seçenekleri
Seçenek 1: Kademeli (yalnızca yeni yüklemeler)
Uygulamanızın OAuth yüklemesi sırasında zaten yaptığı token isteğine expiring=1 ekleyin. Yeni yüklemeler süresi dolan tokenler alır; mevcut yüklemeler, yeniden yükleninceye veya proaktif olarak alışveriş yapana kadar eski tokende kalır.
Arka plan işleri çalıştıran ve 2027 Ocak ayından önce uygulamayı hiçbir zaman açmayan mağazanız varsa, bunu kendi başına kullanmak yetersizdir.
Seçenek 2: Proaktif toplu alışveriş (tüm mevcut yüklemeler)
Her depolanan süresi dolmayan tokeni ticari müşteri etkileşimi olmadan süresi dolan bir çift ile alışveriş yapmak için token alışveriş izni kullanın. Bu, arka plan senkronizasyon işleri olan çoğu uygulamanın ihtiyaç duyduğu şeydir.
| Yaklaşım | Ticari müşteri etkileşimi gerekli | Mevcut yüklemeleri kapsar | Tavsiye edilen |
|---|---|---|---|
Yeni yüklemelere expiring=1 ekleyin | Hayır | Hayır | Ticari müşterilerin sık yeniden yüklendiği uygulamalar |
| Proaktif token alışveriş toplu işi | Hayır | Evet | Arka plan senkronizasyonu, web kancaları, zamanlanmış işler |
| Ticari müşteri uygulamayı açana kadar bekle | Yeniden yetkilendirme istemi | Yalnızca açtıktan sonra | Etkileşimli uygulamalar (önerilmez) |
Tam göçüş adımları
Adım 1: Geçerli token durumunuzu doğrulayın
Oturum depolamanızı kontrol edin. Depolanan erişim tokenleriniz shpat_... gibi görünüyor ve yükleme tarihinden beri hiçbir zaman değişmediyse, süresi dolmayan tokenler üzerinde siz ve Adım 3'te açıklanan Dev Paneli günlüğü filtresini çalıştırarak doğrulayın.
Adım 2: Yeni yüklemeler için OAuth yükleme akışınızı güncelleyin
@shopify/shopify-app-remix veya @shopify/shopify-app-express şablonunu kullanıyorsanız, shopifyApp() yapılandırmanızda expiringOfflineAccessTokens: true etkinleştirin ve yeniden yayınlayın. Şablon depolamayı ve yenilemeyi otomatik olarak işler.
Yetkilendirme kodu iznini doğrudan kullanıyorsanız, yetkilendirme kodunu alışveriş yapan POST'a expiring=1 ekleyin:
POST https://{shop}.myshopify.com/admin/oauth/access_token
client_id={api_key}
client_secret={api_secret}
code={authorization_code}
expiring=1
Token alışverişi (App Bridge oturum tokenları) kullanıyorsanız, alışveriş isteğinize expiring=1 ekleyin:
POST https://{shop}.myshopify.com/admin/oauth/access_token
client_id={api_key}
client_secret={api_secret}
grant_type=urn:ietf:params:oauth:grant-type:token-exchange
subject_token={session_token}
subject_token_type=urn:ietf:params:oauth:token-type:id_token
requested_token_type=urn:shopify:params:oauth:token-type:offline-access-token
expiring=1
Önemli: expiring=1 olmadan, token alışveriş uç noktası, katıldığınızı düşünsünüz bile, eski süresi dolmayan şekli döndürür. Bu, geliştirici forumlarında bildirilen bilinen bir ayakça tuzağıdır.
Adım 3: Her iki tokeni atomik olarak kalıcı hale getirin
Yanıt artık access_token (60 dakikalık TTL) ve refresh_token (90 günlük TTL) ve expires_in ve refresh_token_expires_in içerir. Her ikisini tek bir atomik yazılıda saklayın. Bunları iki ayrı işlemde yazarsanız ve işleminiz aralarında çökerse, uyumsuz bir durumunuz olacaktır.
{
"access_token": "shpua_...",
"expires_in": 3599,
"refresh_token": "shprt_...",
"refresh_token_expires_in": 7775999
}
Not: daha yeni erişim tokenları eski Shopify örneklerinde yaygın olan shpat_ ön eki yerine shpua_ öneki ile ön ek alabilir. Ön ek tabanlı doğrulama mantığını güncelleyin.
Adım 4: Mevcut yüklemeleri token alışverişi yoluyla geçirin
Bu kritik toplu iştir. Oturum depolamanızda halen süresi dolmayan bir tokeni tutan her mağaza için:
POST https://{shop}.myshopify.com/admin/oauth/access_token
client_id={api_key}
client_secret={api_secret}
grant_type=urn:ietf:params:oauth:grant-type:token-exchange
subject_token={existing_non_expiring_token}
subject_token_type=urn:shopify:params:oauth:token-type:offline-access-token
requested_token_type=urn:shopify:params:oauth:token-type:offline-access-token
expiring=1
Hem requested_token_type hem de expiring=1 gereklidir. Shopify, subject_token olarak çevrimiçi tokenları, temsilci tokenlerini, kapsam kısıtlı tokenları ve zaten süresi dolan tokenları reddeder.
Bu alışveriş geri döndürülemez. Başarılı olduktan sonra, eski süresi dolmayan token hemen iptal edilir. Yeni token çiftini işleminiz sonlandırılmadan önce kalıcı hale getirmede başarısız olursanız, bu mağaza uygulamayı yeniden yüklemesi gerekecektir. Bunu bir veritabanı işlemi veya yazma-sonra-onaylama deseni altında çalıştırın.
@shopify/shopify-api Node kütüphanesini kullanıyorsanız, yardımcı yöntemi:
const response = await shopify.auth.migrateToExpiringToken({
session: existingSession,
});
// Save response.session immediately
await sessionStorage.storeSession(response.session);
Adım 5: Uygun kilitleme ile yenileme döngüsünü uygulayın
Standart model, 401'de değil 60 dakikalık pencere kapatılmadan önce proaktif olarak yenilemektir. 401'de yenileme isteğin görünür şekilde başarısız olmasına neden olur; proaktif yenileme işleri temiz tutar.
Temel kurallar:
- Yenilemeden önce mağaza başına dağıtılmış kilit kullanın. Belirli bir zaman için yenileme tokenini yalnızca bir işlem tutmalıdır. Yeni süresi dolan token oluşturma eski olanları devre dışı bıraktığından, eşzamanlı yenileme çağrıları birbirini yetim bırakır.
- Her döndürme işleminde yeni erişim tokenini ve yeni yenileme tokenini atomik olarak depolayın.
- Geçici olmayan hataları ayrı olarak işleyin. Yenileme işleminde 401, yüklenmemiş bir uygulama, kapalı bir mağaza veya iptal edilmiş bir izin anlamına gelebilir. Bunlar yeniden denemeye tabi değildir. Bunları günlüğe kaydedin, oturumu geçersiz olarak işaretleyin ve o mağaza için API çağırmasını durdurun.
async function getValidToken(shop: string): Promise<string> {
const session = await sessionStorage.loadSession(shop);
const bufferSeconds = 120; // refresh 2 min before expiry
if (session.expiresAt - Date.now() / 1000 < bufferSeconds) {
// Acquire per-shop lock here (Redis SETNX or equivalent)
const refreshed = await shopify.session.refreshToken(session);
await sessionStorage.storeSession(refreshed); // atomic
return refreshed.accessToken;
}
return session.accessToken;
}
Adım 6: Göçüşün tamamlandığını doğrulayın
- Dev Paneli Günlükleri görünümüne dönün ve "Offline, non-expiring" token filtresini yeniden çalıştırın. Toplu işlemi işledikçe sayım sıfıra düşmelidir.
- Depolanan oturumlarınızda
refresh_token_expires_inarayın. Eksikse, token süresi dolmaz. - Toplu işten sonra API istemcinizde HTTP 401 yanıtlarını izleyin. Başarılı bir alışverişin hemen ardından gelen yeni 401, kilit veya depolama ıstırmasını gösterir.
Özel uygulamaların yapması gerekenleri (spoiler: hiçbir şey)
Bu değişiklik yalnızca genel uygulamalar için geçerlidir. Özel uygulamalar ve ticari müşteri tarafından oluşturulan uygulamalar kapsam dışındadır. Tek bir ticari müşteri için özel bir entegrasyon oluşturuyor ve bunu İş Ortağı Paneli aracılığıyla özel uygulama olarak dağıtıyorsanız, bu son tarihi uygulamıyor.
Çevrimdışı, çevrimiçi ve temsilci tokenlerinin nasıl farklı olduğu hakkında sözlük girişi için hızlı bir başvuruya bakın.
Kaçınılması gereken yaygın hatalar
- Token alışveriş çağrısında
expiring=1unutmak. Olmadan yanıt geçerli görünür ancak süresi dolmayan bir token alırsınız ve hiçbir şey değişmemiştir. - Yenileme çağrısını mağaza başına kilitlemi meyin. Aynı mağaza için iki eşzamanlı web kancası işleyici her ikisi de yenilemeyi dener, ikincisi birincinin yeni tokenini kullanılmadan önce geçersiz kılar ve 401'lerin basamaklı şekilde sonuçlanırsınız.
- 1 Nisan 2027'yi gerçek son tarih olarak ele almak. Uygulamanız kaldırılır ve ticari müşteriler çok daha önce uyarılar görür. 1 Ocak için planlayın.
- Uygulamayı hiçbir zaman açmayan mağazaları kapsamıyor. Yalnızca arka plan entegrasyonları (örneğin 3 AM envanter senkronizasyonları) yükleme zamanı token yenilemeyi hiçbir zaman tetiklemez. Bu mağazalara proaktif toplu alışveriş gereklidir.
refresh_token_expires_inkontrolünü atlayarak. Toplu işiniz çalışırsa ancak yeni oturumlar bu alanı eksikse, bir şeyler sessizce yanlış gitti.
Sonuç
Göçüş mimaride karmaşık değildir, ancak kısmen yapması ve bitirdiğini düşünmesi kolaydır. Aslında bakım gerektiren üç şey: atomik token depolaması, mağaza başına yenileme kilitleme ve arka planda yalnızca çalışan mağazalar da dahil olmak üzere her mevcut yüklemeyi kapsama. Göçüşün tamamlandığını doğrulamak için toplu işten önce ve sonra Dev Paneli günlüğü filtresini çalıştırın ve "Offline, non-expiring" sayısının sıfıra ulaştığını doğrulayın. 1 Ocak kaldırma tarihinden sekiz hafta kala, bunu aceleyle değil düzgün bir şekilde yapmak için hala zaman var.
Bu işi dışarıya vermek isterseniz, stüdyom Lintel özel Shopify uygulama geliştirme hizmeti veriyor.
Sıkça sorulan sorular
1 Ocak 2027'de göçüş yapılmayan uygulamalar için tam olarak ne bozulur?
Süresi dolan çevrimdışı erişim tokenlerine geçirmeyen uygulamalar 1 Ocak 2027'de Shopify App Store'dan kaldırılacak ve yeni yüklemeleri engellenecektir. Mevcut yüklemeler geçici olarak çalışmaya devam eder, ancak ticari müşteriler Shopify yönetim panelinde 15 Ocak'tan itibaren uyarı iletileri görür ve süresi dolmayan tokenler kullanan Admin API çağrıları 1 Nisan 2027'den itibaren HTTP 403 döndürür.
Göçüşün işe yaraması için ticari müşterinin uygulamayı yeniden yüklemesi gerekir mi?
Hayır. Token alışveriş izni, her depolanan süresi dolmayan tokeni süresi dolan çift için sunucu tarafından tamamen alışveriş etmenizi sağlar. Hiçbir ticari müşteri etkileşimi gerekli değildir. Yeniden yüklemenin gerekli olmasının tek zamanı, alışveriş başarılı olur ancak işleminiz sonlandırılmadan önce yeni tokenları kalıcı hale getirmede başarısız olursanız.
Özel uygulamalar ve ticari müşteri tarafından oluşturulan uygulamalar Ocak 2027 son tarihinden etkilenir mi?
Hayır. Bu değişiklik yalnızca genel uygulamalar için geçerlidir, Shopify App Store'da listelenmiş veya listelenmemiş genel uygulamalar olsun. Özel uygulamalar, ticari müşteri tarafından oluşturulan uygulamalar ve çevrimiçi erişim tokenları açık olarak bu gereksinimin kapsamı dışındadır.