Kimlik doğrulama, temel adres ve sürüm
| Konu | Değer |
|---|---|
| GraphQL adresi | https://MAGAZA.myshopify.com/admin/api/2026-10/graphql.json |
| REST adresi (legacy) | https://MAGAZA.myshopify.com/admin/api/2026-10/KAYNAK.json |
| Kimlik başlığı | X-Shopify-Access-Token |
| Güncel kararlı sürüm | 2026-10 (27 Ekim 2026 itibarıyla) |
| Sürüm desteği | En az 12 ay; desteklenmeyen sürüm en eski kararlı sürümle yanıtlanır |
Yönetici panelinde açılmış eski özel uygulamalar kalıcı bir shpat_ anahtarı verir; yeni Dev Dashboard uygulamalarında anahtar programdan istenir. Ayrıntılar access token nasıl alınır sayfasında.
Sınırlar ve genel hata kodları
| Konu | Değer |
|---|---|
| REST sınırı | Standart planda saniyede 2 istek, kova 40 |
| GraphQL sınırı | Standart planda saniyede 100 puan, tek sorgu en fazla 1.000 puan |
| Sayfa başına öğe | En fazla 250 |
| Sipariş geçmişi | Varsayılan son 60 gün |
| Hata kodları | 401, 402, 403, 404, 422, 429, 5xx |
Ayrıntılar istek sınırları ve hata kodları sayfalarında.
Shopify API işlemleri
Genel
Shopify access token nasıl alınır? Admin API erişim anahtarı ve 2026 değişikliğiHangi yolun hangi tür erişim anahtarı verdiği, 1 Ocak 2026 değişikliği ve kalıcı anahtar bekleyen entegrasyonlar için doğru seçim.Shopify Dev Dashboard ile özel uygulama ve istemci kimlik bilgileri (client credentials)Dev Dashboard’da uygulama oluşturma, yükleme, client ID ve secret ile anahtar isteme, 24 saatlik ömür ve organizasyon kuralı.Shopify Admin API kimlik doğrulama: X-Shopify-Access-Token ve anahtar türleriİsteklerin nasıl doğrulandığı, anahtar türleri ve ömürleri, yenileme, sır döndürme ve iptalin sonuçları.Shopify API erişim kapsamları (scopes): stok ve sipariş senkronu için hangileri gerekir?Ürün, stok, lokasyon ve sipariş senkronu için gereken kapsamlar, sipariş geçmişindeki 60 gün sınırı ve kapsam değişikliğinin yolu.Shopify Admin API: GraphQL mi, REST mi? Eski REST API’nin durumuİki Admin API arasındaki farklar, REST’in legacy durumunun pratik anlamı ve stok senkronu için hangi işlemlerin GraphQL’e taşınması gerektiği.Shopify API sürümleri: 2026-10, destek süresi ve eski sürümde ne olur?Sürüm takvimi, Ekim 2026 itibarıyla desteklenen sürümler, eski sürüm isteğinin nasıl yanıtlandığı ve kullanımdan kaldırma uygulamaları.Shopify API istek sınırları: leaky bucket, REST’te saniyede 2 istek, GraphQL’de sorgu maliyetiSızdıran kova (leaky bucket) mantığı, REST ve GraphQL sınırlarının plana göre değerleri, 429 yanıtı ve sınırı aşmamak için öneriler.Shopify Admin API hata kodları: 401, 402, 403, 404, 422 ve 429REST Admin API durum kodları ve örnek mesajları, GraphQL’de hataların yanıt içinde nasıl döndüğü ve sık sorunların çözümü.
Ürün ve varyant
Shopify ürün ve varyant API: ürünleri okuma, sayfalama ve varyant alanlarıÜrün ve varyantların okunması, imleçli sayfalama, senkron için önemli varyant alanları ve eski ile yeni ürün modelinin sınırları.Shopify API ile ürün oluşturma: productCreate, productSet ve stok atamasıÜrün açmak için GraphQL mutasyonları, eski REST yolu, varyant ve medya kuralları ve stoğun neden ayrı adımda yazıldığı.
Stok
Shopify lokasyon API: location ID nasıl bulunur, stok hangi lokasyondan düşer?Lokasyonların listelenmesi, lokasyon numarasının bulunması, siparişte stoğun hangi lokasyondan düştüğü ve çok depolu mağazada pazaryeri senkronu.Shopify stok güncelleme API: inventorySetQuantities ve inventory_levels/setStoğun lokasyon bazında kesin değer ya da fark olarak yazılması, 2026-04 ile gelen zorunlu alanlar ve eski REST yolu.Shopify envanter durumları: available, on_hand, committed ve diğerleriEnvanter durumlarının anlamı, sipariş yaşam döngüsünde nasıl değiştiği, API ile hangilerinin yazılabildiği ve envanter webhook’ları.
Sipariş
Shopify sipariş API: siparişleri listeleme, 60 gün sınırı ve sipariş alanlarıSiparişlerin REST ve GraphQL ile okunması, varsayılan filtrelerin tuzakları, 60 gün kuralı ve senkron için önemli sipariş alanları.Shopify sipariş durumları: financial_status, fulfillment_status ve iptalÖdeme ve gönderim durumlarının ayrı alanlarda tutulması, değerlerin anlamı, iptalin nasıl anlaşıldığı ve pazaryeri senkronunda eşleme.Shopify sipariş iptali ve iade API: orderCancel ve refundCreateSiparişin API ile iptal edilmesi, iptal koşulları, iade oluştururken para ve stoğun nasıl yönetildiği ve ilgili webhook’lar.
Sık sorulanlar
Shopify Admin API ücretsiz mi?
Admin API mağazanızın bir parçasıdır; özel uygulama açmak için ayrı bir API ücreti yoktur. Bazı özellikler mağaza planına bağlıdır, örneğin istek sınırları Plus planında daha yüksektir.
Shopify’ı pazaryerleriyle aynı stokta tutmak için hangi API’ler gerekir?
Ürün ve varyantları okumak için products, stok için lokasyon ve envanter seviyesi, satışlar için orders kaynakları. Hazır çözüm için Shopify entegrasyonu sayfasına bakabilirsiniz.
Shopify access token’ı nereden alırım?
1 Ocak 2026 öncesi yönetici panelinde açılmış özel uygulamada anahtar yüklemede bir kez gösterilir. Yeni uygulamalar Dev Dashboard’da açılır ve anahtar client ID ile secret kullanılarak programdan istenir.
Shopify stoğu hangi lokasyona yazılır?
Stok her zaman bir envanter kalemi ve bir lokasyon için yazılır. Çok depolu mağazada pazaryerine açtığınız lokasyonu baştan belirleyin.