ConverterHQDevelopers
API v1

Risoluzione dei problemi

Diagnostica autenticazione, upload, Jobs, webhook ed errori del motore in modo ripetibile.

Parti da error code e X-Request-ID; poi controlla ambiente, progetto e stato persistente del Job prima di riprovare.

Identificare la richiesta

Conserva X-Request-ID, job_id, task_id e file_id. Permettono di distinguere problemi di trasporto da errori del motore o rifiuti di capability.

Upload diretti

Se un upload browser fallisce, controlla scadenza URL firmata, Content-Type, dimensione dichiarata e CORS dello storage. I byte non devono passare da /v1/convert.

Jobs e conversioni

Ispeziona Task attempts e code. Non ritentare alla cieca INVALID_CONVERSION_SETTINGS o CONVERSION_OUTPUT_INVALID; correggi richiesta o file.

Escalare con contesto

Fornisci X-Request-ID, ambiente, ora UTC, coppia di formati e fase fallita. Non inviare mai chiavi complete o documenti sensibili su canali non approvati.