Gestion des erreurs
Lisez le statut HTTP avec le corps de la réponse. Les champs d’erreur varient selon le point de terminaison ; consultez le contrat exact dans la référence API.
- Après un délai dépassé ou une erreur 5xx temporaire, vérifiez d’abord tout identifiant de contenu ou de tâche reçu. Pour réessayer la même opération, conservez le même contenu et idempotency_key, avec une attente croissante et un nombre limité de tentatives. HTTP 202 signifie acceptation, pas publication réussie.
- Pour 409 idempotency_conflict, comparez la requête initiale et son résultat. Ne générez pas automatiquement une nouvelle clé. Réservez-la à une nouvelle opération volontaire après vérification de la précédente.
- Corrigez les données, l’authentification ou les permissions avant de réessayer. Pour 429, examinez l’erreur et Retry-After s’il est présent : un quota épuisé peut nécessiter sa réinitialisation ou un changement de forfait, plutôt qu’une courte attente.
{ "error": "insufficient_scope", "message": "publishing:write scope is required for this API request."}