Les erreurs suivent Problem Details et ajoutent un code ConverterHQ stable. Branchez la logique applicative sur code, jamais sur le texte humain.
Problem Details
La réponse contient statut HTTP, code, détail, retryable, paramètre éventuel et request_id pour le diagnostic.
{
"type": "https://converterhq.io/developers/errors/file-password-protected",
"title": "Password protected file",
"status": 422,
"code": "FILE_PASSWORD_PROTECTED",
"retryable": false,
"request_id": "req_..."
}Retry
Ne réessayez automatiquement que les erreurs transitoires. Une erreur de fichier ou d’option déterministe nécessite de corriger l’entrée.
Request IDs
Conservez X-Request-ID: il relie la requête, le Job, les TaskAttempts, les événements et les livraisons webhook.