API Perpustakaan Dokumen dan handoff alur kerja aman
Daftarkan unggahan PDF yang disegel dan dimiliki, periksa metadata pribadi dan aktivitas, perpendek retensi, dan gunakan kembali unggahan yang ada dalam tugas, pekerjaan AI yang dikutip, atau draf penandatanganan sandbox.
Daftarkan PDF yang sudah ada dan tersegel#
Pertama-tama unggah langsung ke penyimpanan pribadi dengan POST /v1/documents/uploads dan POST /v1/documents/uploads/{upload_id}/complete. Unggahan hanya dapat digunakan setelah server menyegel dan memverifikasinya. Kunci API dibatasi pada akun HQTools asli dan proyek API.
POST https://api.pdfhq.io/v1/workspace/documents
x-api-key: PROJECT_API_KEY
Content-Type: application/json
{"upload_id":"SEALED_UPLOAD_UUID","title":"Review draft"}GET /v1/workspace/documents hanya mencantumkan referensi yang tersedia. GET /v1/workspace/documents/{document_id} memeriksa kembali kepemilikan unggahan asli dan kedaluwarsa. DELETE menghapus entri perpustakaan, bukan unggahan yang disimpan di bawahnya.
Pratinjau pribadi dan retensi#
GET https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/preview-url
x-api-key: PROJECT_API_KEY
GET https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/activity
x-api-key: PROJECT_API_KEYTitik akhir preview-url mengembalikan URL yang diotorisasi untuk penyimpanan pribadi dengan masa pakai maksimal 60 detik, dibatasi oleh retensi sumber dan perpustakaan. Perlakukan kueri yang ditandatangani sebagai rahasia dan jangan catat atau simpan di cache. Titik akhir pratinjau yang sudah usang terbatas pada 4 MiB dan memverifikasi sumber yang disegel sebelum mengembalikan byte. Catatan aktivitas GET terbatas pada akun dan proyek API yang sama. PUT /retention hanya dapat mempersingkat ketersediaan perpustakaan; tidak dapat memperpanjang retensi unggahan yang disegel.
Serahkan ke pemrosesan PDF, AI Studio, atau penandatanganan#
POST https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/handoff/task
x-api-key: PROJECT_API_KEY
Content-Type: application/json
{"task_id":"OWNED_TASK_UUID"}
POST https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/handoff/ai
x-api-key: PROJECT_API_KEY
Idempotency-Key: NEW_IDEMPOTENCY_KEY
Content-Type: application/json
{"operation":"pdfhq.ai.summarize","quote_id":"OWNED_HQTOOLS_QUOTE","question":"Key risks?","allow_external_ai":true}
POST https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/handoff/signing
x-api-key: PROJECT_API_KEY
Content-Type: application/json
{"provider":"managed","title":"Review agreement","subject":"Please review","signers":[{"name":"Sample Signer","email":"signer@example.com","order":0}]}Pengalihan tugas tidak menghasilkan biaya. Pengalihan AI mewajibkan penawaran harga biasa, persetujuan penggunaan AI eksternal, isolasi proyek, dan izin melalui satu dompet kredit HQ. Penandatanganan hanya membuat draf: pengiriman permintaan sandbox memerlukan konfirmasi eksplisit terpisah. Dokumen kedaluwarsa atau milik pihak lain tidak pernah diterima.
