Gérez les erreurs et les nouvelles tentatives de l'API

Inspectez toujours le statut HTTP avant de lire une réponse comme un succès. Les services ShareAI peuvent retourner différents formats d'erreur : l'inférence peut fournir error.code, OAuth fournit error et error_description, et les routes de la Console peuvent retourner code, message et data.status.

Statut	Signification typique	Récupération
200 avec un objet d'erreur	Résultat de non-disponibilité de l'appareil dans le point de terminaison de chat actuel.	Inspectez error.code et ne l'affichez pas comme une réponse d'assistant.
400	Requête invalide ou autorisation OAuth refusée.	Corrigez le corps, les paramètres, le callback ou le code expiré/consommé.
401	Authentification manquante, expirée ou invalide.	Vérifiez les identifiants ; actualisez uniquement un jeton OAuth valide.
402	Crédits insuffisants ou solde applicable indisponible.	Vérifiez le solde du compte sélectionné avant de réessayer.
403	Refus lié à la portée, à la propriété, au rôle ou à l'état activé.	Vérifiez la limite de permission documentée.
404	Ressource inconnue ou route de passerelle non prise en charge.	Vérifiez l'hôte, le chemin et les identifiants de ressource.
409	Conflit d'état ou de révision.	Lisez l'état actuel et reconsidérez le changement.
429	Limite de requête ou de concurrence.	Respectez Retry-After et utilisez un backoff limité.
500 / 502 / 503	Échec de disponibilité du serveur ou de l'amont.	Gardez les tentatives limitées ; préservez les identifiants de diagnostic.

Réessayez les lectures avec une limite#

En cas d'échecs temporaires lors des lectures, attendez avec un délai croissant et un jitter, respectez Retry-After lorsqu'il est présent et arrêtez après un nombre défini de tentatives ou un budget de temps. Informez l'utilisateur lorsque les données sont indisponibles au lieu de boucler silencieusement.

Traitez les écritures avec précaution#

Ne répétez pas automatiquement une mise à jour de prix, une création de modèle ou une commande de partage lorsque le résultat est inconnu. Lisez d'abord l'état de la ressource ou de la commande. Utilisez une Idempotency-Key uniquement sur les points de terminaison qui documentent cette prise en charge, comme les modifications d'accord.

Les jetons de rafraîchissement sont à usage unique#

Le rafraîchissement des rotations nécessite un verrouillage par autorisation dans votre backend. Une nouvelle tentative aveugle d'un jeton de rafraîchissement consommé peut révoquer l'autorisation. Voir rafraîchissement sécurisé des jetons.

Que faut-il inclure dans une demande de support#

Incluez le point de terminaison, le statut HTTP, le code d'erreur, l'heure et l'identifiant de réponse/tâche lorsque disponible. Supprimez les en-têtes Authorization, cookies, secrets clients, jetons d'accès, jetons de rafraîchissement et contenus privés des invites.