ConverterHQDevelopers
API v1

Solução de problemas

Diagnostique autenticação, uploads, Jobs, webhooks e falhas de engine de forma repetível.

Comece pelo código de erro e X-Request-ID; depois confirme ambiente, projeto e estado durável do Job antes de repetir qualquer coisa.

Identificar a requisição

Guarde X-Request-ID, job_id, task_id e file_id. Eles separam falhas de transporte de erro do engine ou rejeição de capability.

Uploads diretos

Se o upload no navegador falhar, revise validade da URL assinada, Content-Type, tamanho declarado e CORS do storage. Os bytes não devem passar por /v1/convert.

Jobs e conversões

Inspecione Task attempts e o code. Não repita cegamente INVALID_CONVERSION_SETTINGS ou CONVERSION_OUTPUT_INVALID; corrija a requisição ou arquivo.

Escalar com contexto

Envie X-Request-ID, ambiente, horário UTC, par de formatos e etapa que falhou. Nunca envie chave completa ou documento sensível por canal não aprovado.