Pemeriksaan awal sebelum mengunggah
Periksa kelayakan operasi PDF, metadata bertanda tangan, batas batch, dan estimasi kredit HQ sebelum menyegel atau mengunggah berkas.
Validasi operasi PDF tanpa mengunggah#
POST /v1/preflight memvalidasi rencana operasi PDF, metadata, pengaturan, pembatasan paket, dan perkiraan kredit HQ tanpa mengalokasikan penyimpanan, membuat tugas, atau membebankan kredit. Sertakan format, size_bytes, dan page_count untuk setiap berkas. Autentikasi memakai sesi akun atau kunci API dengan izin tugas; permintaan anonim terbatas tidak dapat melihat saldo.
curl -X POST 'https://api.pdfhq.io/v1/preflight' -H 'Content-Type: application/json' -H 'x-api-key: YOUR_API_KEY' -d '{"operation":"merge","inputs":[{"format":"pdf","size_bytes":51200,"page_count":2},{"format":"pdf","size_bytes":40960,"page_count":3}],"file_count":2,"settings":{}}'Periksa supported, eligible, can_proceed, blockers, quote, dan next_actions. Hanya penawaran yang diverifikasi secara terpusat oleh HQTools yang dapat menyelesaikan pemblokiran yang bisa diatasi melalui pembelian. Permintaan yang tidak didukung secara teknis tidak boleh menampilkan paywall.
Eksekusi dan keamanan#
Pembatasan laju dan validasi permintaan yang ketat melindungi endpoint anonim. Pemeriksaan awal yang berhasil tidak memesan kredit, menetapkan harga, atau membuktikan isi PDF yang diunggah. Tandatangani dan unggah langsung ke penyimpanan, buat tugas, lalu biarkan server memvalidasi ulang dokumen asli, hak akses, kuota, dan kredit HQ saat eksekusi.
SDK referensi menyediakan preflight(request) dalam sepuluh bahasa, sementara spesifikasi OpenAPI aktif /openapi.json menjelaskan kontrak publik. Tangani respons HTTP 422 (validasi), 429 (pembatasan laju), dan 503 (tidak tersedia).
