ConverterHQDevelopers
API v1

Erros

Erros estáveis e legíveis por máquina com orientação de retry e request IDs.

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.

Problem Details
{
  "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.