Tanda tangani API PDF (Tanda Terlihat).
Tempatkan nama yang diketik, tanggal atau gambar tanda tangan yang digambar pada PDF menggunakan siklus hidup tugas yang diukur. Ini tidak memverifikasi identitas atau mengeluarkan tanda tangan kriptografi yang didukung sertifikat.
Semantik endpoint dan tugas#
Kode operasi: sign
Mulai operasi ini dengan POST /v1/tasks dan kode alat yang ditampilkan di atas. Unggah dan lampirkan PDF sumber (atau gunakan titik akhir unggahan berskop tugas), lalu panggil POST /v1/tasks/{task_id}/process dengan pengaturan operasi.
Tambahkan tanda tangan terlihat yang ditinjau, inisial, atau tanggal ke dokumen dengan izin dari penandatangan.
Input: Tepat satu PDF tersegel; 1–12 tanda; maksimal 100 MiB dan 500 halaman (batas paket mungkin lebih rendah). Dokumen yang sudah berisi tanda tangan digital ditolak.
Konfigurasi dan parameter tambahan#
| Pengaturan | Jenis | Perilaku |
|---|---|---|
| markswajib | object[] | 1–12 tanda; masing-masing mencakup halaman (berbasis 1), x0, y0, x1, y1 dalam poin PDF sudut kiri atas dan jenis: diketik, tanggal, atau digambar. Tanda yang diketik/tanggal menyertakan teks; tanda yang digambar menyertakan byte PNG base64 (tanpa awalan URL data). Gambar maks 96 KiB, 1600 × 600 piksel. |
Opsi divalidasi oleh API. Pengaturan yang tidak dikenal dan nilai yang tidak didukung mengembalikan kesalahan alih-alih diabaikan.
Urutan permintaan yang sedang berjalan#
Programming language: cURL
Pilih bahasa · gulir secara horizontal untuk semua 10 bahasa SDK
# Server-side API calls. Save the returned task_id.
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks' \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"tool":"sign"}'
# Upload and verify 1 PDF(s), then obtain and approve a credit quote:
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID/quote' -H 'x-api-key: YOUR_API_KEY'
# ONLY after explicit customer approval:
test "$PDFHQ_APPROVE_QUOTE" = yes || { echo "Approval required" >&2; exit 1; }
curl -fsS -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":{"marks":[{"kind":"typed","page":1,"x0":72,"y0":650,"x1":320,"y1":715,"text":"Jane Doe"}]}}'
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID' -H 'x-api-key: YOUR_API_KEY'After starting a task, upload and verify PDFs, review the credit quote, and get explicit approval before processing. API keys belong on your server, never on signed storage uploads.
Paket yang dapat diunduh yang dihasilkan mencakup alur kerja tugas saja. SDK layanan penuh memerlukan spesifikasi OpenAPI runtime yang terverifikasi; SDK tugas Python, JavaScript, dan TypeScript melakukan streaming unggahan file; bahasa lain memerlukan unggahan multipart yang ditandatangani yang diimplementasikan oleh pemanggil.
ID tugas yang dikembalikan digunakan untuk polling status dan pengambilan. Setelah tugas berhasil, minta URL output yang ditandatangani daripada menyematkan rahasia unduhan.
Output dan detail penting#
PDF baru yang berisi tanda tanda tangan terlihat di persegi panjang yang diminta. Halaman sumber dan teks asli tetap dapat diakses.
Operasi ini TIDAK membuat sertifikat digital, jejak audit penerima, atestasi kepatuhan hukum atau verifikasi identitas penandatangan. Tanda tangan digital PDF yang ada ditolak; halaman target yang diputar tidak didukung. Untuk alur kerja tanda tangan penerima tingkat bisnis, integrasikan penyedia khusus.
Kesalahan, percobaan ulang, dan penagihan