REST durum kodları
| Kod | Anlamı | Belgedeki örnek mesaj |
|---|---|---|
| 401 Unauthorized | Kimlik bilgisi geçersiz | [API] Invalid API key or access token |
| 402 Payment Required | Mağaza dondurulmuş | This shop’s plan does not have access to this feature |
| 403 Forbidden | Çoğunlukla yanlış erişim kapsamı | User does not have access |
| 404 Not Found | Kaynak bulunamadı | Not Found |
| 422 Unprocessable Entity | Gövdede anlamsal hata | The fulfillment order is not in an open state. |
| 429 Too Many Requests | İstek sınırı aşıldı | Exceeded 2 calls per second for api client |
| 5xx | Shopify’da iç hata | An unexpected error occurred |
402 için belge, mağaza sahibinin ödenmemiş bakiyeyi ödeyerek mağazayı açması gerektiğini söyler. 5xx hatalarında Shopify durum sayfasına bakmanız önerilir.
GraphQL’de hatalar
GraphQL Admin API’de iş kuralı hataları çoğunlukla HTTP 200 ile, mutasyonun döndürdüğü userErrors listesinde gelir. Bu yüzden yalnız HTTP koduna bakmak yetmez.
| Yer | Örnek | Ne yapmalı |
|---|---|---|
| userErrors | inventorySetQuantities’te CHANGE_FROM_QUANTITY_STALE | Güncel değeri okuyup yeniden deneyin |
| errors ve ACCESS_DENIED | Çevrimiçi anahtarın kullanıcısının yetkisi yok | Kullanıcı ya da anahtar türünü değiştirin |
| HTTP 401 | Anahtarın süresi doldu | Yeni anahtar alın |
| HTTP 429 | Yeni varyant günlük kısıtı ya da genel sınır | Bekleyip yeniden deneyin |
Her mutasyon yanıtında userErrors alanını isteyin ve boş değilse işlemi başarısız sayın.
Sık sorunlar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| 401, anahtar yeni alındı | Anahtar eksik kopyalandı ya da başka mağazaya ait | Anahtarı ve mağaza adresini birlikte kontrol edin |
| Ertesi gün 401 | 24 saatlik anahtar kullanılmış | Kalıcı anahtar ya da otomatik yenileme |
| Stok yazarken 403 | write_inventory kapsamı yok | Kapsamı ekleyin |
| GraphQL sorgusu çalışmadan reddedildi | Sorgunun istenen maliyeti 1.000 puanı aştı | first değerlerini küçültün ya da toplu işlem kullanın |
| Sürekli 429 | İstekler paralel gönderiliyor | Sıraya koyup saniyede 2 isteğin altına inin |
| Yanıt alanları beklenenden farklı | Desteklenmeyen sürüm istendi | X-Shopify-API-Version başlığına bakın |
Kimlik sorunlarının ayrıntısı kimlik doğrulama ve anahtar türleri sayfasında.
Hata ayıklarken kaydedilecekler
- İsteğin yöntemi, adresi ve kullandığınız API sürümü
- Yanıtın durum kodu ve errors ya da userErrors içeriği
- X-Shopify-API-Version ve X-Shopify-Shop-Api-Call-Limit başlıkları
- 429 yanıtlarında Retry-After değeri
Erişim anahtarını kayıtlara yazmayın; başlığı maskeleyin. Shopify destek ekibine başvururken bu bilgiler sorunu hızla daraltır.
Sık sorulanlar
Shopify API 401 hatası nasıl çözülür?
Anahtarın doğru ve eksiksiz kopyalandığını, mağaza adresiyle aynı mağazaya ait olduğunu ve süresinin dolmadığını kontrol edin. Gerekirse yeni anahtar alın.
403 Forbidden ne demek?
Belgeye göre bu kod çoğunlukla yanlış ya da eksik erişim kapsamından kaynaklanır. Uygulamanın kapsamlarını kontrol edin.
402 Payment Required hatası neden gelir?
Mağaza dondurulmuştur. Mağaza sahibinin ödenmemiş bakiyeyi ödemesi gerekir.
GraphQL isteğim 200 döndü ama işlem olmadı, neden?
GraphQL’de iş kuralı hataları userErrors listesinde gelir. Yanıtta bu alanı isteyip kontrol edin.
Kaynaklar
İlgili Shopify API konuları
Son güncelleme: 27.10.2026 · Shopify API rehberinin tamamı