ConverterHQDevelopers
API v1

Rozwiązywanie problemów

Diagnozuj auth, uploady, Jobs, webhooks i błędy engine w powtarzalny sposób.

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.