Erreurs et reprises

Interpréter les erreurs Gateway et reprendre les appels sans dupliquer une réunion.

Les erreurs utilisent une enveloppe stable :

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "The request is invalid.",
    "requestId": "request_opaque",
    "retryable": false
  }
}

Conservez le requestId pour le support, sans lui associer de clé ni de contenu confidentiel.

Codes publics

HTTP	Code	Conduite à tenir
400	`INVALID_REQUEST`	Corriger la requête ou le curseur
401	`AUTHENTICATION_FAILED`	Remplacer ou faire vérifier la clé
403	`AUTHORIZATION_DENIED`	Demander le scope manquant
404	`NOT_FOUND`	Vérifier la référence et l'installation propriétaire
409	`IDEMPOTENCY_CONFLICT`	Ne pas réutiliser la clé avec une autre requête
409	`INVALID_MEETING_STATE`	Respecter l'état courant de la réunion
429	`RATE_LIMITED`	Attendre avant une nouvelle tentative
500	`INTERNAL_ERROR`	Réessayer avec une attente bornée
502	`UPSTREAM_INVALID_RESPONSE`	Signaler si le problème persiste
503	`UPSTREAM_UNAVAILABLE`	Réessayer avec une attente bornée
504	`UPSTREAM_DEADLINE_EXCEEDED`	Réessayer avec une attente bornée

Reprendre une écriture

Si la réponse à un POST est perdue, renvoyez exactement la même requête avec la même Idempotency-Key. Le serveur renvoie le résultat initial.

Ne générez pas une nouvelle clé après un résultat réseau inconnu : vous risqueriez de créer une seconde ressource.

Polling

Les lectures d'état, de transcription et de synthèse peuvent être répétées. Utilisez une cadence espacée, une attente croissante bornée et une échéance globale propre à votre application. Arrêtez immédiatement sur un état terminal ou une erreur non rejouable.