Logo PDFHQ

Dokumen

Kesalahan API dan percobaan ulang

Respons kesalahan terstruktur, idempotency, dan pemulihan pemrosesan asinkron.

Kunci API sisi server Unggahan penyimpanan yang ditandatangani

Kegagalan HTTP yang dapat diprediksi#

401/403 menunjukkan kegagalan autentikasi atau hak akses. 404 menyembunyikan objek yang tidak dapat diakses. 409 menandakan pengaturan yang tidak dapat diubah, unggahan yang sudah digunakan, atau status tugas yang tidak valid. 413 memberlakukan batas ukuran, 422 memvalidasi pengaturan, dan 429 adalah pembatasan laju/konkurensi.

Kegagalan layanan komersial sementara atau antrian mengembalikan 503. Ulangi pemrosesan dengan ID tugas yang sama dan opsi identik, menggunakan backoff eksponensial dan anggaran percobaan ulang yang dibatasi.

Contoh pemulihan#

cURL
# Safe repeated processing attempt for the SAME task and options
curl -X POST https://api.pdfhq.io/v1/tasks/TASK_ID/process \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"options":{"compression_level":"recommended"}}'

Tugas pemrosesan yang gagal tidak dapat dibalikkan hanya dengan menghapus tugas. Konsultasikan penggunaan akun dan dukungan saat menyelidiki ketidaksesuaian penyelesaian.

Logo PDFHQ

Alat PDF dan intelijen dokumen. Siapkan, pahami, dan bekerja dengan dokumen Anda.

© 2026 PDFHQ. Semua hak dilindungi.