ConverterHQDevelopers
API v1

Resolución de problemas

Diagnostica autenticación, cargas, Jobs, webhooks y fallos de motor con un flujo repetible.

Empieza por el código de error y X-Request-ID; después comprueba entorno, proyecto y estado persistente del Job antes de reintentar.

Identificar la petición

Guarda X-Request-ID, job_id, task_id y file_id. Permiten separar problemas de transporte de fallos de motor o rechazo de capability.

Cargas directas

Si falla una carga desde navegador, revisa caducidad de URL firmada, Content-Type, tamaño declarado y CORS del almacenamiento. Los bytes no deben atravesar /v1/convert.

Jobs y conversiones

Inspecciona Task attempts y el code. No reintentes a ciegas INVALID_CONVERSION_SETTINGS o CONVERSION_OUTPUT_INVALID; corrige petición o archivo.

Escalar con contexto

Incluye X-Request-ID, entorno, hora UTC, par de formatos y etapa que falló. Nunca envíes una API key completa ni un documento sensible por un canal no aprobado.