ConverterHQDevelopers
API v1

Dépannage

Diagnostiquer rapidement auth, uploads, Jobs, webhooks et erreurs moteur.

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é.