Hatalar

Durum kodları

Durum	Gövde	Anlamı	Ne yapmalı
400	{"error": "…"} veya bir doğrulama problemi	İstek hatalı biçimlendirilmiş ya da belgelenmiş bir sınırı aşıyor.	İsteği düzeltin. Değiştirmeden yeniden denemeyin.
401	(boş)	Token eksik, bilinmiyor, süresi dolmuş veya iptal edilmiş; kurulum kaldırılmış; uygulama askıya alınmış ya da mağaza aktif değil.	Bir kez yeni token alın. O da başarısız olursa durun ve uyarı verin — kurulum artık yok ya da devre dışı.
403	(boş)	Kurulumunuzda bu işlemin gerektirdiği scope (yetki) yok.	Tüccardan bu izni vermesini isteyin. İşlemin referans sayfası scope’u belirtir.
404	değişir	Kayıt bu mağazada yok. Başka bir mağazaya ait kayıt her zaman 404 döner, asla 403 değil.	—
409	{"error": "…"}	Bu anahtara sahip idempotent bir istek hâlâ çalışıyor.	Retry-After kadar bekleyin ve aynı anahtarla yeniden deneyin.
422	{"error": "…"}	Bu Idempotency-Key zaten farklı bir istekle kullanılmış.	Yeni bir istek için yeni bir anahtar kullanın.
429	{"error": "…"}	Rate limit (istek sınırı) aşıldı.	Retry-After saniye kadar bekleyin.
5xx	problem details	Bir platform hatası. İç ayrıntılar asla dahil edilmez.	Backoff ile yeniden deneyin; idempotent yazmaları yeniden denemek güvenlidir.

Toplu route’larda kısmi başarı normaldir

Toplu route’lar — toplu ürün güncellemeleri ve medya içe aktarımları — istek geçerli olduğunda 200 döner ve her satırı ayrı ayrı raporlar. failed: 3 içeren bir 200, üç satırın uygulanmadığı anlamına gelir. Satır başına status değerini her zaman okuyun.

Ayrıştırmamanız gereken gövdeler

401 ve 403 şu anda boş gövdeye sahiptir. Platform nedeni bilir (örneğin tenant_not_active) ama henüz döndürmez. Bunları yalnızca durum koduna göre ele alın. Bkz. kısıtlamalar.