Erros seguem Problem Details e adicionam um código ConverterHQ estável. A aplicação deve usar code e não texto humano.
Problem Details
A resposta inclui status HTTP, code, detail, retryable, parâmetro opcional e 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_..."
}Retry
Repita automaticamente apenas falhas transitórias. Erros determinísticos de arquivo ou opção exigem mudar a entrada.
Request IDs
Guarde X-Request-ID: ele liga request, Job, TaskAttempts, eventos e diagnósticos de webhook.