Uygulamayı oluşturmak ve yüklemek
| Adım | Nerede | Not |
|---|---|---|
| 1 | Ayarlar > Uygulamalar > Develop apps > Build apps in Dev Dashboard | Dev Dashboard açılır |
| 2 | Uygulama oluştur | Ad verin |
| 3 | Sürüm oluştur | Uygulama adresi, Webhooks API sürümü, erişim kapsamları |
| 4 | Sürümü yayımla | İsteğe bağlı sürüm adı ve mesajı |
| 5 | Installs > Install app | Mağazayı seçip onaylayın |
Yardım Merkezi’ne göre özel uygulama yalnız aynı organizasyonun parçası olan mağazalara yüklenebilir. Mağaza sahibi tam yetkilidir; personelin App development > Develop iznine ihtiyacı vardır. Ortak çalışan (collaborator) hesapları Dev Dashboard’a erişemez.
Anahtarı istemek
Client ID ve client secret, Dev Dashboard’da uygulamanın Settings ekranında durur. Anahtar şu istekle alınır; değerler sahtedir.
- Adres: POST https://magaza-adi.myshopify.com/admin/oauth/access_token
- İçerik türü: application/x-www-form-urlencoded
- grant_type: client_credentials
- client_id: CLIENT_ID
- client_secret: CLIENT_SECRET
| Yanıt alanı | Anlamı |
|---|---|
| access_token | Admin API isteklerinde kullanılacak anahtar |
| scope | Anahtarın taşıdığı kapsamlar |
| expires_in | Saniye cinsinden ömür; her zaman 86399, yani 24 saat |
Belgeye göre Shopify bu istekte scope parametresini yok sayar. Anahtar, mağazanın uygulama kurulumuna verdiği bütün kapsamları taşır.
24 saatlik ömürle yaşamak
Bu anahtarın yenileme anahtarı yoktur. Süre dolmadan aynı isteği yeniden gönderip yeni anahtar alırsınız.
- Anahtarı bellekte saklayın ve expires_in değerinden bitiş zamanını hesaplayın.
- Bitişten bir süre önce, belgedeki örnekte bir dakika önce, yeni anahtar isteyin.
- Her API çağrısı için yeni anahtar istemeyin.
- Süreyi koda sabit yazmayın; Shopify yanıttaki expires_in değerini okumanızı önerir.
Bu nedenle bu yol, anahtarı bir kez yapıştırıp unutan yazılımlara uygun değildir. Entegrasyonun client ID ve secret’ı saklayıp anahtarı kendisinin yenilemesi gerekir.
Aynı organizasyon şartı ve sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| Anahtar isteği reddediliyor | Uygulama ile mağaza aynı organizasyonda değil | Dev Dashboard’da Dev stores listesinde mağazayı arayın |
| Birden çok organizasyon var | Uygulama ve mağaza farklı organizasyonlarda | Adresteki organizasyon numarasını karşılaştırın |
| Müşterinizin mağazasına bağlanamıyorsunuz | Client credentials başka organizasyona ulaşmaz | Özel dağıtım ve yetkilendirme kodu akışını kullanın |
| Ertesi gün 401 | 24 saatlik anahtarın süresi doldu | Anahtarı süre dolmadan yenileyin |
Belge, mağazaya sahip olmanın ya da uygulamanın mağazada yüklü olmasının o mağazayı otomatik olarak organizasyonunuza katmadığını vurgular. Client secret’ı ortam değişkeninde ya da gizli anahtar yöneticisinde tutun, kod deposuna koymayın.
Sık sorulanlar
Shopify Dev Dashboard’da access token nerede görünür?
Görünmez. Yardım Merkezi’ne göre bu yolda anahtar Shopify yöneticisinden kopyalanamaz; geliştirici onu client ID ve client secret ile istemci kimlik bilgileri akışından ister.
Client credentials anahtarı ne kadar geçerli?
24 saat. Yanıttaki expires_in her zaman 86399 saniyedir; süre dolmadan aynı istekle yenisi alınır.
Müşterimin mağazasına client credentials ile bağlanabilir miyim?
Hayır. Bu akış yalnız uygulamayla aynı organizasyondaki mağazalarda çalışır. Başka organizasyonun mağazası için özel dağıtım ve yetkilendirme kodu akışı gerekir.
Kapsamları istek sırasında seçebilir miyim?
Hayır. Shopify bu istekteki scope parametresini yok sayar; anahtar mağazanın uygulamaya verdiği bütün kapsamları taşır.
Kaynaklar
İlgili Shopify API konuları
Son güncelleme: 27.10.2026 · Shopify API rehberinin tamamı