Erreurs et nouvelles tentatives

Toutes les erreurs applicatives suivent ce contrat :

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests.",
    "retryable": true,
    "request_id": "f8971bc1-4c57-4f65-a846-9a9cebea63cc"
  }
}

HTTP	Action
`400` / `422`	Corriger la requête ; ne pas réessayer automatiquement
`401`	Créer un nouveau token ou vérifier les identifiants
`403`	Vérifier le scope ou la capability
`404`	Vérifier l’identité et la conversation
`409`	Examiner `error.code` : conflit d’idempotence ou traitement encore actif
`413`	Réduire le corps de la requête
`429`	Backoff exponentiel avec jitter
`503`	Réessayer progressivement

Réutilisez un client_message_id uniquement pour rejouer le même message. Cela permet de reprendre après une coupure sans créer de réponse en double.

idempotency_conflict : utilisez un nouveau client_message_id si le contenu a changé.
turn_in_progress : attendez assistant.completed ou assistant.error avant de supprimer le tour ou sa conversation.

En sandbox, daily_message_limit_exceeded signifie que les 50 nouveaux messages de l’application ont été utilisés pour la journée. Le quota se réinitialise à 00:00 UTC. Une reprise idempotente avec le même client_message_id et le même contenu reste autorisée.

Démarrage

Intégration