Commencez toujours par le code d’erreur et X-Request-ID, puis vérifiez l’environnement, le projet et l’état durable du Job avant de relancer quoi que ce soit.
Identifier la requête exacte
Conservez X-Request-ID, job_id, task_id et file_id. Ils permettent de distinguer un problème de transport d’un échec moteur ou d’un refus de capacité.
Uploads directs
Si un upload navigateur échoue, vérifiez d’abord l’expiration de l’URL signée, Content-Type, la taille annoncée et CORS du stockage. Les octets ne doivent pas transiter par /v1/convert.
Jobs et conversions
Inspectez les Task attempts et le code machine. Ne réessayez pas aveuglément INVALID_CONVERSION_SETTINGS ou CONVERSION_OUTPUT_INVALID; corrigez la requête ou le fichier.
Escalade utile
Fournissez X-Request-ID, environnement, heure UTC, paire de formats et étape ayant échoué. N’envoyez jamais une clé API complète ni un document sensible sauf canal de support explicitement approuvé.