İnceleme 2026-11-10 · API sürümü 2026-11-09 · Markdown oku
Hatalar, yeniden denemeler ve kurtarma
API hataları; isteğe bağlı alan hataları, hedef hataları, yeniden deneme ipuçları ve
eylem devirleriyle birlikte { "error": { "code": "…", "message": "…", "requestId": "…" } }
biçimini kullanır. Destek için requestId değerini saklayın. Tanılama toplarken kimlik
bilgilerini, imzalı yükleme URL'lerini veya hassas istek içeriğini günlüğe yazmayın.
| Yanıt | Kurtarma |
|---|---|
401 unauthenticated | Eksik, bozuk veya iptal edilmiş ürün anahtarını kontrol edin |
403 forbidden_scope / account_not_allowed | Anahtar kapsamlarını ve hedef erişimini gözden geçirin |
402 account_limit, seat_limit, storage_limit | Çalışma alanı yetkilendirmesini ve kaynak kullanımını gözden geçirin |
402 subscription_inactive / trial_expired | Faturalama durumunu çözün; taslakları ve kuyruktaki işleri koruyun |
409 revision_conflict | Geçerli sürümü okuyun, değişiklikleri inceleyin ve kasıtlı olarak yeniden uygulayın |
409 idempotency_conflict | Anahtar farklı bir gövdeyle yeniden kullanıldı; özgün işlemi mutabık kılın |
409 consent_required | Yetkili bir kişiden verilen inceleme devrini tamamlamasını isteyin |
409 too_late_to_cancel | Gerçek teslimat durumunu inceleyin; iptalin başarılı olduğunu iddia etmeyin |
media_expired / media_deleting | Orijinalleri yeniden yükleyin ve taslağı güncelleyin |
422 validation_failed | Yapılandırılmış alanları veya hedef başına sorunları düzeltin |
429 rate_limited | Retry-After değerine uyun; eşzamanlılığı azaltın ve geri çekilme kullanın |
submission_unknown | Yeni bir gönderim denemeden önce mevcut harici sonucu mutabık kılın |
Güvenli mutasyon yeniden denemeleri
İlk mutasyondan önce bir idempotency anahtarı oluşturun ve tam isteğini saklayın.
Yanıt kaybolmuşsa işlem zaten başarılı olmuş olabilir. Özdeş isteği aynı anahtarla
yeniden gönderin; ağ zaman aşımı nedeniyle asla taze bir anahtar oluşturmayın. MCP
mutasyon araçları anahtarlarını yankılar; buna transport_outcome_unknown
başarısızlıkları dâhildir. Bağdaştırıcı mutasyonları otomatik yeniden denemez.
Teknik çalışma alanı hız sınırları paylaşım kredisi değildir. Geçerli plan ve hız
bilgisi için /usage uçlarını kullanın. Yalnızca geçici hatalar için uygun olduğunda
geri çekilin; yetkilendirme, doğrulama veya insan onayı hatalarını nedenini değiştirmeden
yeniden denemek fayda sağlamaz.
Kısmi başarı ve gözlem
Kabul edilmiş bir yayın/zamanlama toplu işlemi bağımsız teslimatlardan oluşur. Başarılı makbuzları ve yerel bağlantıları saklayın. Başarısız bir hedefi, tüm toplu işlemi yeniden oluşturmak yerine kendi yeniden deneme uç noktası üzerinden kurtarın. İmzalı webhook'ları tercih edin; yoklama yapıyorsanız artan gecikmelerle sınırlı sayıda deneme yapın ve çözülmemiş işi bir kişiye iletin.