ConverterHQDevelopers
API v1

Troubleshooting

Diagnosis autentikasi, upload, Jobs, webhooks, dan kegagalan engine secara konsisten.

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.