Mulai dari error code dan X-Request-ID, lalu periksa environment, project, dan state Job yang durable sebelum melakukan retry.
Identifikasi request
Simpan X-Request-ID, job_id, task_id, dan file_id. ID ini membedakan masalah transport dari kegagalan engine atau penolakan capability.
Upload langsung
Jika upload browser gagal, periksa masa berlaku signed URL, Content-Type, ukuran yang dideklarasikan, dan storage CORS. Byte file tidak boleh melewati /v1/convert.
Jobs dan konversi
Periksa Task attempts dan code. Jangan retry buta INVALID_CONVERSION_SETTINGS atau CONVERSION_OUTPUT_INVALID; perbaiki request atau file.
Eskalasi dengan konteks
Kirim X-Request-ID, environment, waktu UTC, pasangan format, dan langkah yang gagal. Jangan pernah mengirim API key lengkap atau file sensitif melalui kanal yang tidak disetujui.