Shopify Uygulamaları Oluşturma: Shopify Uygulama Ekosistemi İçin Geliştirici Kılavuzu

Shopify App Store 10.000'den fazla uygulamaya ev sahipliği yapıyor ve geliştiricilere milyarlarca dolar gelir sağlıyor. İster tek bir satıcı için özel bir uygulama ister binlerce mağaza için genel bir uygulama oluşturuyor olun, Shopify'ın uygulama mimarisini, API'lerini ve ekosistemini anlamak çok önemlidir. Bu kılavuz, geliştiricilerin 2026'da Shopify uygulamalarını oluşturmak, başlatmak ve ölçeklendirmek için bilmesi gereken her şeyi kapsar.

S: Ne tür Shopify uygulamaları oluşturabilirsiniz?

Üç tür Shopify uygulaması vardır: Shopify App Store'da herhangi bir satıcının yüklemesi için listelenen herkese açık uygulamalar, tek bir belirli mağaza için oluşturulmuş özel uygulamalar ve geliştirme ve test sırasında kullanılan taslak uygulamalar. Herkese açık uygulamalar Shopify'ın inceleme sürecinden geçerken, özel uygulamalar doğrudan mağazanın yöneticisi aracılığıyla yüklenir.

Uygulama Türlerinin Açıklaması

Herkese Açık Uygulamalar

Herkese açık uygulamalar Shopify App Store'da listelenir ve herhangi bir Shopify satıcısı tarafından yüklenebilir. Kimlik doğrulama için OAuth kullanırlar ve Shopify'ın uygulama inceleme yönergelerine uymaları gerekir.

Özellikler:

• 4,8 milyondan fazla Shopify mağazasının tamamında mevcut
• Abonelikler, kullanım ücretleri veya tek seferlik satın alımlardan elde edilen gelir
• Shopify'ın uygulama inceleme sürecini geçmelidir
• Satıcı kimlik doğrulaması için OAuth 2.0'ı kullanın
• Shopify'ın App Store politikalarına ve kalite standartlarına tabidir

Özel Uygulamalar

Özel uygulamalar tek bir mağaza için oluşturulmuştur ve App Store inceleme sürecinden geçmez. Doğrudan mağazanın yönetici paneli aracılığıyla yüklenirler.

Özellikler:

• Belirli bir satıcı için tasarlandı
• App Store listelenmesine gerek yok
• Shopify yöneticisinde oluşturulan jetonlara erişim
• OAuth akışına gerek yok
• Özel iş mantığı ve entegrasyonlar için ideal

Taslak Uygulamalar

Taslak uygulamalar geliştirme sırasında kullanılır. Herkese açık uygulamalar gibi çalışırlar ancak yalnızca geliştirme mağazalarına yüklenebilirler. App Store'a gönderildikten sonra herkese açık uygulamalara dönüşürler.

Geliştirme Ortamınızı Kurma

Shopify CLI

Shopify CLI, uygulama geliştirmeye yönelik resmi komut satırı aracıdır. Projelerin iskelesini kurar, geliştirme mağazalarını yönetir ve uygulama dağıtımını yönetir.

Başlarken:

1. Node.js 18+ ve npm'yi yükleyin
2. Shopify CLI'yi yükleyin: npm install -g @shopify/cli @shopify/app
3. Yeni bir uygulama oluşturun: shopify app init
4. Çerçevenizi seçin (Remix varsayılan ve önerilen seçimdir)
5. Geliştirmeye başlayın: shopify app dev

CLI, yerel geliştirme için otomatik olarak ngrok tünelleri kurar, uygulama kimlik doğrulamasını yönetir ve etkin modülün yeniden yüklenmesini sağlar.

Geliştirme Mağazası

Shopify İş Ortağı Kontrol Paneliniz aracılığıyla ücretsiz bir geliştirme mağazası oluşturun. Geliştirme mağazaları tüm Shopify özelliklerine tam erişime sahiptir ve ücretli bir plan gerektirmez. Test için sınırsız geliştirme mağazaları oluşturabilirsiniz.

Shopify API'leri

Shopify, farklı kullanım durumları için çeşitli API'ler sağlar:

| API'si | Kimlik Doğrulama | Kullanım Örneği | |-----|---------------|----------| | Yönetici API'si (REST) ​​| OAuth / Erişim Jetonu | Mağaza yönetimi, siparişler, ürünler, müşteriler | | Yönetici API'si (GraphQL) | OAuth / Erişim Jetonu | REST ile aynı ancak esnek sorgulamayla | | Vitrin API'si | Vitrin Erişim Jetonu | Müşteriye yönelik özellikler, başsız ticaret | | Ödeme API'si | Ödeme Erişim Jetonu | Özel ödeme deneyimleri (yalnızca Plus) | | Ödeme Uygulamaları API'sı | İş ortağı kimlik bilgileri | Ödeme ağ geçidi entegrasyonu | | İşlev API'si | Wasm modülleri | Özel indirimler, nakliye, doğrulama mantığı |

Yönetici API'sı

Admin API, mağaza verilerini yönetmek için kullanılan birincil arayüzdür. Ürünlere, siparişlere, müşterilere, envantere, sipariş karşılamaya ve daha fazlasına erişim sağlar.

GraphQL ve REST:

Shopify, yeni geliştirmeler için GraphQL Yönetici API'sini önerir. Faydaları şunları içerir:

• Tam olarak ihtiyacınız olan alanları isteyin (fazladan getirme yok)
• İlgili kaynakları tek bir istekte getirin
• İç gözlemle güçlü bir şekilde yazılmış şema
• Daha iyi oran limiti kullanımı (talep bazlı yerine maliyet bazlı)

GraphQL örneği -- Ürünler getiriliyor:

query {
  products(first: 10) {
    edges {
      node {
        id
        title
        variants(first: 5) {
          edges {
            node {
              price
              inventoryQuantity
            }
          }
        }
      }
    }
  }
}

Oran sınırları:

• GraphQL Admin API: Saniyede 1.000 maliyet puanı (her alanın bir maliyeti vardır)
• REST Admin API: Saniyede 40 istek (Temel/Shopify), 80 (Gelişmiş/Artı)
• Vitrin API'si: saniyede 100 maliyet puanı

Vitrin API'si

Storefront API, müşteriye yönelik deneyimler için tasarlanmıştır. Ürünlere, koleksiyonlara ve sepet işlevlerine kimliği doğrulanmamış erişim sağlar. Oluştururken kullanın:

• Özel vitrinler (başsız ticaret)
• Mobil uygulamalar
• Harici web sitelerine gömülü satın alma düğmeleri
• Ürün öneri widget'ları

Web kancaları

Web kancaları, bir satıcının mağazasında olaylar meydana geldiğinde uygulamanıza bilgi verir. Shopify, veriler değiştiğinde API'yi yoklamak yerine uç noktanıza HTTP POST istekleri gönderir.

Çoğu uygulama için temel web kancaları:

• orders/create -- Yeni sipariş verildi
• orders/updated -- Sipariş durumu değişti
• products/update -- Ürün verileri değiştirildi
• products/delete -- Ürün kaldırıldı
• app/uninstalled -- Satıcı uygulamanızın yüklemesini kaldırdı
• shop/update -- Mağaza ayarları değiştirildi

Webhook'un en iyi uygulamaları:

1. Hızlı yanıt verin -- 5 saniye içinde 200 durumunu döndürün; verileri eşzamansız olarak işlemek
2. Yinelenenleri ele alın -- Shopify aynı webhook'u birden çok kez gönderebilir; iktidarsızlık uygulamak
3. İmzaları doğrulayın -- Orijinalliği onaylamak için X-Shopify-Hmac-SHA256 başlığını doğrulayın
4. Yeniden deneme mantığını uygulayın -- Uç noktanız başarısız olursa Shopify 48 saat içinde 19 defaya kadar yeniden dener
5. Zorunlu web kancalarını kullanın -- Uyumluluk için app/uninstalled, customers/data_request, customers/redact ve shop/redact'yi kaydedin

App Bridge ve Polaris ile Uygulama Kullanıcı Arayüzü Oluşturma

Shopify Uygulama Köprüsü

App Bridge, uygulamanızın kullanıcı arayüzünün Shopify yöneticisi içinde oluşturulmasını sağlar. Şunları sağlar:

• Shopify'ın yönetici kenar çubuğuyla navigasyon entegrasyonu
• Kalıcı diyaloglar, tost bildirimleri ve yükleme çubukları
• Ürünleri, koleksiyonları ve müşterileri seçmek için kaynak seçici
• Birincil ve ikincil eylemlerin yer aldığı başlık çubuğu

Polaris Tasarım Sistemi

Polaris, Shopify'ın React bileşen kitaplığıdır. Shopify'ın yönetici tasarım diliyle eşleşen önceden oluşturulmuş kullanıcı arayüzü bileşenleri sağlar:

• Formlar, düğmeler ve giriş alanları
• Veri tabloları ve kaynak listeleri
• Kartlar, afişler ve düzen bileşenleri
• Tarih seçiciler, filtreler ve sayfalandırma

Polaris'i kullanmak, uygulamanızın Shopify yöneticisinde yerel görünmesini ve tasarım incelemesinden geçmesini sağlar.

Shopify İşlevleri

Shopify İşlevleri, WebAssembly (Wasm) kullanarak Shopify'ın altyapısı üzerinde özel iş mantığını çalıştırmanıza olanak tanır. Eski Komut Dosyası Düzenleyici komut dosyalarının yerini alırlar ve ticaret akışındaki önemli noktalarda çalışırlar:

• İndirim İşlevleri -- Özel indirim mantığı (BOGO, kademeli fiyatlandırma, toplu indirimler)
• Gönderim İşlevleri -- Özel gönderim ücretleri ve teslimat seçenekleri
• Ödeme İşlevleri -- Ödeme sırasında ödeme yöntemlerini gizleyin veya yeniden sıralayın
• Doğrulama İşlevleri -- Özel sepet ve ödeme doğrulama kuralları
• Karşılama İşlevleri -- Özel sipariş karşılama konumu yönlendirmesi

İşlevler 5 ms'nin altında bir sürede yürütülür ve Shopify'ın sunucularında çalışır; böylece vitrin teknolojisinden (Sıvı, Hidrojen veya üçüncü taraf) bağımsız olarak çalışmalarını sağlar.

Uygulama İnceleme Süreci

Herkese açık uygulamaların App Store'da listelenmeden önce Shopify'ın incelemesinden geçmesi gerekir. İnceleme şunları değerlendirir:

Teknik gereksinimler:

• Uygulama, Shopify API'lerinin en son sürümlerini kullanmalıdır
• Doğru kapsamlarla doğru OAuth uygulaması
• Tüm uç noktalar için HTTPS
• GDPR uyumluluğu için zorunlu web kancası işleyicileri
• Hata işleme ve zarif bozulma

Kullanıcı deneyimi gereksinimleri:

• Yönetici arayüzü için Polaris bileşenlerini kullanın
• Açıkça başlangıç ve kurulum talimatları sağlayın
• Uygulamaya bir yardım/destek bağlantısı ekleyin
• Tüm yönetici ekranı boyutları için duyarlı tasarım

İş gereksinimleri:

• Açık ve doğru App Store listesi
• Şeffaf fiyatlandırma ve faturalandırma
• Gizlilik politikası ve hizmet şartları
• Makul yanıt sürelerine sahip destek kanalı

Yaygın reddedilme nedenleri:

1. Gereksiz API izin kapsamlarını istemek
2. Eksik GDPR web kancası işleyicileri
3. Polaris yönergelerine uymayan zayıf kullanıcı arayüzü
4. Yetersiz hata yönetimi
5. İnceleme sırasında bozuk işlevsellik

İnceleme süreci genellikle 7-14 iş günü sürer. Geri bildirimleri hemen ele alın -- Shopify, gerekli değişiklikler konusunda özel rehberlik sağlar.

Para Kazanma Stratejileri

Shopify, Faturalandırma API'si aracılığıyla çeşitli faturalandırma modellerini destekler:

| Modeli | En İyisi | Örnek | |----------|----------|-----------| | Aylık abonelik | Temel uygulama özellikleri | Temel için ayda 9,99 ABD doları, profesyonel için ayda 29,99 ABD doları | | Yıllık abonelik | Taahhütlü müşteriler | $99/yıl (aylık indirim) | | Kullanıma dayalı faturalandırma | Değişken tüketim | API çağrısı veya gönderilen e-posta başına 0,01 ABD doları | | Tek seferlik şarj | Ömür boyu erişim | 49,99 $ tek seferlik satın alma | | Ücretsiz | Kullanıcı edinimi | Ücretli yükseltmelerle ücretsiz katman |

Fiyatlandırma ipuçları:

• Shopify, ilk 1 milyon ABD Doları gelirden %15, ardından %0 gelir payı alır (mevcut iş ortağı programı koşulları itibarıyla)
• Ücretsiz deneme olanağı sunun (7-14 gün standarttır)
• Fiyatlandırma katmanları arasında net değer farklılaşması yaratın
• Değişken kaynak tüketimine sahip uygulamalar için kullanıma dayalı fiyatlandırmayı düşünün

Test ve Kalite Güvencesi

Uygulamanızı incelemeye göndermeden önce:

1. Birim testleri -- Temel iş mantığını ayrı ayrı test edin
2. Entegrasyon testleri -- Shopify'ın geliştirme mağazasıyla API etkileşimlerini test edin
3. Kullanıcı arayüzü testleri -- Polaris bileşenlerinin doğru şekilde oluşturulduğunu doğrulayın
4. Web kancası testleri -- Web kancası işlemeyi test verileriyle doğrulayın
5. Performans testleri -- API çağrılarının yük altında hız sınırları dahilinde kalmasını sağlayın
6. Güvenlik denetimi -- XSS, CSRF ve ekleme güvenlik açıklarını kontrol edin
7. OAuth akış testi -- Kurulumu, kimlik doğrulamayı ve kaldırma işlemini doğrulayın

Farklı mağaza yapılandırmalarını ve plan türlerini simüle etmek için Shopify'ın iş ortağı kontrol panelini kullanın.

Profesyonel Uygulama Geliştirme

Shopify uygulaması oluşturmak, React, GraphQL, Node.js ve Shopify'ın belirli platform modellerinde uzmanlık gerektirir. ECOSIRE, mevcut uygulamaların sunduklarının ötesinde özel işlevselliğe ihtiyaç duyan işletmeler için profesyonel Shopify uygulama geliştirme hizmetleri sağlar.

İster kendi mağazanız için özel bir uygulamaya ihtiyacınız olsun ister Shopify ekosistemi için genel bir uygulama oluşturmak isteyin, geliştirme ekibimiz mimariyi, geliştirmeyi, testi ve App Store gönderimini üstlenir. Ayrıca Shopify'ın API'leri ve web kancalarıyla entegre olan otomasyon çözümleri de sunuyoruz.

Shopify uygulama geliştirme projeniz hakkında görüşmek için ekibimizle iletişime geçin.

Temel Çıkarımlar

• Shopify üç uygulama türü sunar: genel (App Store), özel (tek mağaza) ve taslak (geliştirme)
• Yeni geliştirmeler için REST yerine GraphQL Yönetici API'si önerilir
• Web kancaları yoklama olmadan gerçek zamanlı olay işlemeyi mümkün kılar
• Shopify İşlevleri, WebAssembly aracılığıyla Shopify'ın altyapısında özel iş mantığını çalıştırır
• App Bridge ve Polaris, uygulamanızın Shopify yöneticisiyle sorunsuz bir şekilde entegre olmasını sağlar
• Uygulama inceleme süreci 7-14 gün sürer ve teknik kalite, kullanıcı deneyimi ve iş gereksinimleri değerlendirilir
• Faturalandırma API'si aracılığıyla abonelikler, kullanıma dayalı faturalandırma veya tek seferlik ücretlendirmeler yoluyla para kazanın