Hatalar ve yeniden denemeler

Hatalar, kararlı ve makine tarafından okunabilir bir error kodu ve eşleşen HTTP durumu ile JSON olarak döndürülür.

{
  "error": "rate_limited",
  "message": "Too many requests.",
  "retry_after_ms": 850
}

Hata kodları

HTTP	`error`	Yeniden dene?	Notlar
400	`invalid_request`	Hayır	Bir parametre doğrulamayı geçemedi — isteği düzeltin.
401	`missing_api_key` / `unknown_api_key`	Hayır	Bkz. Kimlik doğrulama.
403	`inactive_api_key` / `account_blocked`	Hayır	Anahtar devre dışı veya hesap askıya alınmış.
402	`insufficient_credits`	Hayır	Bakiye yükleyin. Gövde `required` ve `balance` içerir.
429	`rate_limited`	Evet, `retry_after_ms` sonrasında	Dakika başına sınırınızı aştınız.
409	`request_in_progress`	Evet	Aynı idempotent istek hâlâ çalışıyor.
422	(idempotency çakışması)	Hayır	Bir `Idempotency-Key` farklı bir gövdeyle yeniden kullanıldı.
503	`service_temporarily_unavailable` / `too_many_concurrent_requests`	Evet, geri çekilmeyle	Geçici kapasite sınırı.
504	`result_timeout`	Evet	Üst akış getirmesi `deadline_ms` süresini aştı.

429 / 503 / 504 / 409 hatalarını üstel geri çekilmeyle yeniden deneyin. retry_after_ms mevcut olduğunda, yeniden denemeden önce en az o kadar bekleyin.
400 / 401 / 402 / 403 hatalarını asla yeniden denemeyin — siz değiştirmediğiniz sürece istek başarılı olmayacaktır.
Resmi SDK’ler geçici hataları sizin için zaten yeniden dener (varsayılan 2 yeniden deneme) ve hatada bir retryable bayrağı sunar.