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.