Kesalahan API dan percobaan ulang
Respons kesalahan terstruktur, idempotency, dan pemulihan pemrosesan asinkron.
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#
# 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.
