Unggahan PDF langsung
Unggahan penyimpanan presigned aman, checksum SHA-256, penyelesaian unggahan dan kedaluwarsa.
Pustaka dokumen#
Setelah menyegel unggahan, daftarkan upload_id dan judulnya dengan POST /v1/workspace/documents. Perpustakaan menyimpan referensi akun dan kunci API yang dibatasi ruang lingkup, tanpa menyalin file atau memperpanjang kedaluwarsa aslinya.
Daftar, ubah nama, dan hapus referensi di bawah /v1/workspace/documents. Pratinjau dan titik akhir aktivitas memeriksa kembali kepemilikan dan kedaluwarsa. PUT / {document_id}/retensi menerima stempel waktu retained_until yang hanya dapat mempersingkat ketersediaan. Menghapus referensi akan membuat unggahan asli tetap berada di bawah kebijakan penyimpanan yang ada.
POST /{document_id}/handoff/task melampirkan sumber ke tugas; /handoff/ai memerlukan kutipan normal, persetujuan AI eksternal yang eksplisit, dan Kunci Idempotensi; /handoff/signing membuat draf untuk ditinjau dan dikirim secara terpisah. OAuth memerlukan files.read atau files.write untuk operasi perpustakaan, jobs.write untuk serah terima tugas, ai.write untuk serah terima AI, dan tanda tangan.tulis untuk serah terima penandatanganan.
Penerimaan file#
Minta upload yang sudah ditandatangani menggunakan POST /v1/documents/uploads dengan nama file, content_type=application/pdf, size_bytes, dan SHA-256 huruf kecil dari byte sumber yang tepat. Respons berisi URL POST S3 dan bidang formulir multipart yang ditandatangani.
Kirim semua bidang yang dikembalikan tanpa diubah dan file ke URL S3. Kemudian panggil POST /v1/documents/uploads/{upload_id}/complete untuk memverifikasi ukuran dan metadata serta menyegel objek. Hanya unggahan siap yang dapat dilampirkan ke tugas. Lebih suka POST /v1/tasks/{task_id}/uploads dan tautan penyelesaian yang dikembalikan untuk secara otomatis melampirkan file.
curl -X POST https://api.pdfhq.io/v1/documents/uploads \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"filename":"report.pdf","content_type":"application/pdf","size_bytes":12345,"sha256":"ACTUAL_64_CHAR_DIGEST"}'Privasi dan batas#
Unggahan tugas dapat dilampirkan ke satu tugas saja. Tiket unggahan kedaluwarsa; ukuran, tanda tangan PDF, dan ringkasan harus cocok. Jangan simpan URL yang ditandatangani atau catat konten file sensitif. Pelanggan dapat menghapus unggahan yang tidak digunakan sebelum dikirimkan ke pekerjaan.
