Zacznij od error code i X-Request-ID, następnie sprawdź środowisko, projekt i trwały stan Job przed retry.
Zidentyfikuj request
Zachowaj X-Request-ID, job_id, task_id i file_id. Pozwalają odróżnić transport od błędu engine lub odrzucenia capability.
Bezpośrednie uploady
Przy błędzie uploadu w przeglądarce sprawdź ważność signed URL, Content-Type, zadeklarowany rozmiar i storage CORS. Bajty nie mogą przechodzić przez /v1/convert.
Jobs i konwersje
Sprawdź Task attempts i code. Nie retryuj ślepo INVALID_CONVERSION_SETTINGS ani CONVERSION_OUTPUT_INVALID; popraw request lub plik.
Eskaluj z kontekstem
Podaj X-Request-ID, environment, czas UTC, parę formatów i etap błędu. Nie wysyłaj pełnego API key ani wrażliwego dokumentu niezatwierdzonym kanałem.