Behandeln Sie API-Fehler und Wiederholungen

Überprüfen Sie immer den HTTP-Status, bevor Sie eine Antwort als Erfolg lesen. ShareAI-Dienste können unterschiedliche Fehlerformate zurückgeben: Inferenz kann bereitstellen error.code, OAuth liefert error und error_description, und Konsolenrouten können zurückgeben code, message und data.status.

Status	Typische Bedeutung	Wiederherstellung
200 mit einem Fehlerobjekt	Kein Geräteverfügbarkeits-Ergebnis im aktuellen Chat-Endpunkt.	Überprüfen Sie error.code und geben Sie es nicht als Assistentenantwort aus.
400	Ungültige Anfrage oder OAuth-Gewährung.	Korrigieren Sie den Body, die Parameter, den Callback oder den abgelaufenen/verbrauchten Code.
401	Fehlende, abgelaufene oder ungültige Authentifizierung.	Überprüfen Sie die Anmeldedaten; aktualisieren Sie nur eine gültige OAuth-Berechtigung.
402	Unzureichende Guthaben oder anwendbares Saldo.	Überprüfen Sie den Kontostand des ausgewählten Kontos, bevor Sie es erneut versuchen.
403	Bereich, Eigentum, Rolle oder Aktivierungsstatus verweigert.	Überprüfen Sie die dokumentierte Berechtigungsgrenze.
404	Unbekannte Ressource oder nicht unterstützte Gateway-Route.	Überprüfen Sie Host-, Pfad- und Ressourcenkennungen.
409	Status- oder Revisionskonflikt.	Lesen Sie den aktuellen Status und überdenken Sie die Änderung.
429	Anfrage- oder Gleichzeitigkeitslimit.	Beachten Sie Retry-After und verwenden Sie ein begrenztes Backoff.
500 / 502 / 503	Server- oder Upstream-Verfügbarkeitsfehler.	Halten Sie Wiederholungen begrenzt; bewahren Sie Diagnosekennungen.

Wiederholen Sie Lesevorgänge mit einem Limit#

Bei temporären Fehlern beim Lesen warten Sie mit zunehmender Verzögerung und Jitter, beachten Sie Retry-After, falls vorhanden, und stoppen Sie nach einer definierten Anzahl von Versuchen oder einem Zeitbudget. Zeigen Sie dem Benutzer an, wenn Daten nicht verfügbar sind, anstatt stillschweigend zu wiederholen.

Behandeln Sie Schreibvorgänge sorgfältig#

Wiederholen Sie ein Preisupdate, eine Modellerstellung oder einen Freigabebefehl nicht automatisch, wenn das Ergebnis unbekannt ist. Lesen Sie zuerst den Ressourcen- oder Befehlsstatus. Verwenden Sie einen Idempotency-Key nur bei Endpunkten, die Unterstützung dokumentieren, wie z. B. bei Vertragsänderungen.

Aktualisierungstokens sind nur einmal verwendbar#

Die Aktualisierung der Rotation erfordert eine Autorisierungssperre in Ihrem Backend. Ein blindes Wiederholen eines verbrauchten Aktualisierungstokens kann die Berechtigung widerrufen. Siehe sichere Token-Aktualisierung.

Was in eine Supportanfrage aufgenommen werden sollte#

Geben Sie den Endpunkt, den HTTP-Status, den Fehlercode, die Zeit und die Antwort-/Aufgabenkennung an, wenn verfügbar. Entfernen Sie Autorisierungsheader, Cookies, Client-Geheimnisse, Zugriffstokens, Aktualisierungstokens und private Eingabeinhalte.