API hatalarını ve yeniden denemeleri yönetin

Bir yanıtı başarı olarak okumadan önce her zaman HTTP durumunu inceleyin. ShareAI hizmetleri farklı hata zarfları döndürebilir: çıkarım error.code, sağlayabilir, OAuth error ve error_description, sağlayabilir ve Konsol rotaları code, message ve data.status.

Durum	döndürebilir.	Tipik anlam
Kurtarma	Bir hata nesnesi ile 200.	Mevcut sohbet uç noktasında cihaz kullanılabilirliği sonucu yok.
400	error.code'u inceleyin ve bunu bir asistan yanıtı olarak göstermeyin.	Geçersiz istek veya OAuth yetkisi.
401	Eksik, süresi dolmuş veya geçersiz kimlik doğrulama.	Kimlik bilgilerini kontrol edin; yalnızca geçerli bir OAuth iznini yenileyin.
402	Yetersiz kredi veya uygun bakiye.	Tekrar denemeden önce seçilen hesap bakiyesini kontrol edin.
403	Kapsam, sahiplik, rol veya etkinleştirilmiş durum reddi.	Belgelenmiş izin sınırını kontrol edin.
404	Bilinmeyen kaynak veya desteklenmeyen ağ geçidi rotası.	Ana bilgisayar, yol ve kaynak tanımlayıcılarını kontrol edin.
409	Durum veya revizyon çakışması.	Mevcut durumu okuyun ve değişikliği yeniden değerlendirin.
429	İstek veya eşzamanlılık sınırı.	Retry-After'a uyun ve sınırlı bir geri çekilme kullanın.
500 / 502 / 503	Sunucu veya yukarı akış erişilebilirlik hatası.	Tekrar denemeleri sınırlı tutun; tanılama tanımlayıcılarını koruyun.

Okumaları bir sınırla yeniden deneyin#

Okumalardaki geçici hatalar için, artan gecikme ve rastgelelik ile bekleyin, Retry-After varsa buna uyun ve tanımlı bir deneme veya zaman bütçesi sonrasında durun. Veriler mevcut olmadığında kullanıcıya gösterin, sessizce döngüye girmeyin.

Yazımları dikkatlice ele alın#

Sonuç bilinmediğinde bir fiyat güncellemesini, model oluşturma veya paylaşım komutunu otomatik olarak tekrarlamayın. Önce kaynağı veya komut durumunu okuyun. Sadece destek dokümantasyonu olan uç noktalarda Idempotency-Key kullanın, örneğin anlaşma değişikliklerinde.

Yenileme token'ları tek kullanımlıktır#

Yenileme döngüsü, arka ucunuzda yetkilendirme başına bir kilit gerektirir. Tüketilmiş bir yenileme jetonunun kör bir şekilde yeniden denenmesi yetkiyi iptal edebilir. Bakınız güvenli jeton yenileme.

Bir destek talebine neler dahil edilmeli#

Uç noktayı, HTTP durumunu, hata kodunu, zamanı ve yanıt/görev tanımlayıcısını mevcut olduğunda dahil edin. Authorization başlıklarını, çerezleri, istemci sırlarını, erişim jetonlarını, yenileme jetonlarını ve özel istem içeriklerini kaldırın.