8 Kasım 2026 · 7 dk okuma

Shopify Çevrimdışı Erişim Tokeni Süresi Doldurması: 1 Ocak'ta Neler Bozulur ve Tam Göçüş Adımları

Her genel Shopify uygulamasının 1 Ocak 2027 tarihine kadar süresi dolan çevrimdışı erişim tokenlerine geçmesi gerekir, aksi takdirde uygulamanın

Shopify Çevrimdışı Erişim Tokeni Süresi Doldurması: 1 Ocak'ta Neler Bozulur ve Tam Göçüş Adımları

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.

TarihNe olur
1 Nisan 2026Süresi dolan tokenler tüm yeni genel uygulamalar için gerekli
1 Ocak 2027Göçüş yapılmayan uygulamalar App Store'dan kaldırılır, yeni yüklemeleri engellenir; mevcut yüklemeler hala çalışır
15 Ocak 2027Göçüş yapılmayan uygulamaları kullanan ticari müşteriler Shopify yönetim panelinde uyarı görür
1 Nisan 2027Sü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şımTicari müşteri etkileşimi gerekliMevcut yüklemeleri kapsarTavsiye edilen
Yeni yüklemelere expiring=1 ekleyinHayırHayırTicari müşterilerin sık yeniden yüklendiği uygulamalar
Proaktif token alışveriş toplu işiHayırEvetArka plan senkronizasyonu, web kancaları, zamanlanmış işler
Ticari müşteri uygulamayı açana kadar bekleYeniden yetkilendirme istemiYalnızca açtıktan sonraEtkileş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_in arayı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=1 unutmak. 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_in kontrolü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.

shopifyauthenticationadmin apioauthapp development

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.

Yedi yıllık Shopify, tek sayfada.

Roller, projeler, teknoloji yığını ve sertifikalar özgeçmişte.

Özgeçmiş PDF indir LinkedIn