Los errores usan Problem Details más un código estable de ConverterHQ. La lógica debe ramificar por code y no por texto humano.
Problem Details
La respuesta incluye estado HTTP, code, detail, retryable, parámetro opcional y request_id.
{
"type": "https://converterhq.io/developers/errors/file-password-protected",
"title": "Password protected file",
"status": 422,
"code": "FILE_PASSWORD_PROTECTED",
"retryable": false,
"request_id": "req_..."
}Reintentos
Reintenta automáticamente solo errores transitorios. Errores deterministas de archivo u opciones requieren cambiar la entrada.
Request IDs
Conserva X-Request-ID: enlaza la solicitud, el Job, TaskAttempts, eventos y diagnósticos de webhooks.