Hata Çözüm Merkezi

Shopify REST Admin API 429 ve Retry-After: İstek Sınırı Yönetimi

Shopify REST Admin API 429 yanıtının anlamı, Retry-After başlığının kullanımı ve entegrasyon iş kuyruğu tasarımı.

Codariva ·

Shopify'ın REST Admin API çağrıları bazı durumlarda 429 Too Many Requests yanıtıyla sınırlandırılabilir. Bu sayfa özellikle REST Admin API kullanan mevcut/legacy entegrasyonları ele alır; Shopify yeni entegrasyonlar için GraphQL Admin API kullanılmasını önerir.

Retry-After ne söyler?

Shopify REST Admin API belgelerine göre limit aşıldığında 429 yanıtı ile birlikte Retry-After başlığı dönebilir. Bu başlık, yeniden çağrı göndermeden önce beklenmesi gereken süreyi belirtir. Aynı anda çok sayıda tekrar denemek bekleme kuyruğunu daha da büyütebilir.

Ne yapmalısınız?

  • İstek başına endpoint, mağaza ve yanıt kodunu izleyin.
  • API cevabında varsa Retry-After değerini dikkate alın.
  • İşleri adil bir kuyrukta sıraya koyun; her mağaza için ayrı trafik yönetimi değerlendirin.
  • Tekrar denemelerin çift sipariş veya çift kayıt üretmesini engelleyin.
  • Büyük veri aktarımlarını yoğun olmayan dönemlerde planlayın ve daha uygun API desenlerini araştırın.

Sık görülen mimari hata

Bir ERP–e-ticaret entegrasyonunda her SKU için sık aralıkla ayrı API çağrısı göndermek gereksiz yük yaratabilir. Güncellenecek kayıtları belirlemek, değişiklikleri gruplamak ve kaynakların desteklediği etkin yöntemleri kullanmak daha sürdürülebilir olabilir.

Önlem testi

Limit aşıldığı durumda kullanıcıya yanlış başarı mesajı verilmemeli. Kuyruk gecikmesi, son başarılı eşitleme ve bekleyen işlem sayısı operasyon ekibine gösterilmeli.

Örnek yanıtı nasıl yorumlamalı?

Aşağıdaki temsilî yanıt, bu mağaza ve uygulamanın istek sınırına ulaştığını gösterir. Bekleme süresi bitmeden yeni deneme planlanmaz; arada aynı mağazaya çalışan diğer işler de dikkate alınır.

HTTP 429 Too Many Requests
Retry-After: 2.0
X-Shopify-Shop-Api-Call-Limit: 40/40

Bu sayılar örnektir, her mağaza planı için sabit kota değildir. Shopify rate limit belgesi.

Durum Uygulanacak yaklaşım
Geçerli Retry-After Belirtilen süreden erken deneme yapmayın
Başlık eksik/bozuk Kendi sınırlı bekleme politikanızı kullanın; nedenini inceleyin
Sürekli 429 Yükü ve aktarım kapsamını düşürün; tekrar bütçesi dolunca durun

Yeni projelerde REST yerine güncel GraphQL Admin API yaklaşımı değerlendirilmelidir; onun maliyet ve sorgu sınırları REST'teki istek sayısı modeliyle aynı değildir. Bu rehber GraphQL hatalarının çözümü olarak kullanılmamalıdır.

Kaynaklar ve doğrulama

Örnek akışlar mimari öneridir; tamamlanmış müşteri projesi veya üretici iş ortaklığı iddiası değildir. Teknik kaynak kontrolü: 17 Ekim 2026. Kurulumun sürümü, lisansı ve izinleri ayrıca doğrulanır.

İşletmenizdeki akışa uyarlayın

ERP entegrasyonu planlama rehberi. Özel yazılım geliştirme kapsamını inceleyebilir, mevcut sürecinizi birlikte değerlendirebiliriz.

İhtiyacınızı konuşalım →