Sızdıran kova nasıl çalışır?
- Her uygulama ve mağaza çiftinin bir kovası vardır.
- Her istek kovaya bir miktar bilye atar; REST’te istek başına bir, GraphQL’de sorgunun maliyeti kadar.
- Kova, API’nin geri dolum hızıyla sürekli boşalır.
- Kova dolarsa istek 429 ile reddedilir; yer açılınca yeniden kabul edilir.
Ortalama hızınız geri dolum hızının altında kaldığı sürece kısa patlamalar sorun yaratmaz. Bir uygulamanın çağrıları başka bir uygulamanın sınırını etkilemez. Shopify platform kararlılığı için sınırları geçici olarak düşürebileceğini de belirtir.
Plana göre sınırlar
| Plan | REST Admin API | GraphQL Admin API |
|---|---|---|
| Standart | Saniyede 2 istek, kova 40 | Saniyede 100 puan |
| Advanced Shopify | Saniyede 4 istek | Saniyede 200 puan |
| Shopify Plus | Saniyede 20 istek, kova 400 | Saniyede 1.000 puan |
| Shopify for enterprise | Saniyede 40 istek | Saniyede 2.000 puan |
GraphQL’de tek bir sorgu, plandan bağımsız olarak 1.000 puanı geçemez. Bu sınır sorgu çalışmadan önce, istenen maliyete göre denetlenir.
REST’te sınırı izlemek
| Başlık | Anlamı |
|---|---|
| X-Shopify-Shop-Api-Call-Limit: 32/40 | Kovada 32 istek var, kapasite 40 |
| Retry-After: 2.0 | 429 sonrası beklenecek saniye |
Kova zamanla boşalır: 39/40 gösteren başlık, on saniye sonra 19/40 olur. 429 aldığınızda Retry-After süresi dolmadan yapılan her istek yine reddedilir.
REST’te ayrıca sayfa numarasıyla 100.000’den büyük bir ofsete ulaşan GET istekleri 429 alır. Sayfa numarasıyla sayfalama 2019-07’de kullanımdan kalktı; imleçli sayfalama kullanın.
GraphQL’de sorgu maliyeti
| Alanın döndürdüğü | Varsayılan maliyet |
|---|---|
| Skaler, enum | 0 |
| Nesne | 1 |
| Bağlantı (connection) | first ya da last değerine göre |
| Mutasyon | 10 |
Yanıttaki extensions.cost alanı istenen ve gerçekleşen maliyeti, throttleStatus ise kovadaki boş puanı ve geri dolum hızını gösterir. Shopify-GraphQL-Cost-Debug=1 başlığıyla alan alan maliyet dökümü alınır. Gerçek maliyet istenenden düşükse fark kovaya iade edilir.
Diğer sınırlar ve öneriler
- Dizi alan girdiler en fazla 250 öğe olabilir.
- Sayfalama 25.000 nesnede sınırlanır; sayım sorguları da buna dahildir.
- 500.000 varyanta ulaşan mağazada günde en fazla 10.000 yeni varyant oluşturulabilir; bu kısıt Plus planında yoktur.
- Büyük okumalar için toplu işlemleri (bulk operations) kullanın; tek sorgu sınırlarına tabi değildir.
- Hata alınca yeniden denemeden önce bekleyin; Shopify’ın önerdiği bekleme süresi bir saniyedir.
- Sık kullanılan verileri önbelleğe alın ve yalnız gereken alanları isteyin; REST’te fields parametresi, GraphQL’de dar alan seçimi işinizi görür.
Sık sorulanlar
Shopify REST API’de saniyede kaç istek atabilirim?
Standart planda ortalama 2 istek; kova 40 isteğe kadar kısa patlamaya izin verir. Advanced planda 4, Plus planında 20 istektir.
GraphQL Admin API sınırı nasıl hesaplanır?
İstek sayısı değil sorgu maliyeti sayılır. Standart planda saniyede 100 puan geri dolar; tek sorgu 1.000 puanı geçemez.
429 Too Many Requests alınca ne yapmalıyım?
Retry-After başlığındaki süre kadar bekleyip tekrar deneyin. Süre dolmadan yapılan istekler yine reddedilir.
Kalan kapasiteyi nereden görürüm?
REST’te X-Shopify-Shop-Api-Call-Limit başlığından, GraphQL’de yanıtın extensions.cost.throttleStatus alanından.
Kaynaklar
İlgili Shopify API konuları
Son güncelleme: 27.10.2026 · Shopify API rehberinin tamamı