Tanda PDF - Tanda Tangan Digital API
PDF4me Tanda PDF memungkinkan Anda menambahkan gambar tanda tangan ke PDF dokumen dengan kendali atas posisi, ukuran, dan tampilan. Ini API proses layanan PDF file dan menambahkan gambar tanda tangan menggunakan Base64 Pengkodean untuk transmisi yang aman. The API menerima PDF data gambar konten dan tanda tangan melalui REST API solusi ini ideal untuk otentikasi dokumen, kepatuhan hukum, alur kerja bisnis, dan menambahkan tanda tangan visual ke dokumen.
Memverifikasi Identitas Anda API Meminta
Untuk mengakses PDF4me REST APISetiap permintaan harus menyertakan kredensial otentikasi yang tepat. Otentikasi memastikan komunikasi yang aman dan memvalidasi identitas Anda sebagai pengguna yang berwenang. REST API.
Fitur Utama
- Dukungan Tanda Tangan GambarTambahkan gambar tanda tangan khusus ke PDF dokumen dengan kendali penuh atas posisi dan ukuran
- Penempatan FleksibelKontrol perataan horizontal dan vertikal dengan akurasi setingkat piksel.
- Ukuran KhususSesuaikan dimensi tanda tangan menggunakan pengukuran milimeter dan piksel.
- Pemformatan LanjutanAtur opasitas, margin, dan opsi latar belakang untuk tampilan profesional.
- Penargetan Halaman: Menandatangani halaman tertentu atau seluruh dokumen
- Kontrol Cetak: Konfigurasikan tanda tangan agar hanya muncul dalam bentuk cetak atau di layar
- Hasil ProfesionalBuat tanda tangan yang meningkatkan otentikasi dan keamanan dokumen.
- Pemrosesan AsinkronDukungan untuk pemrosesan asinkron dengan polling untuk operasi yang berjalan lama.
REST API Titik akhir
Yang PDF4me REST API menggunakan standar HTTP metode untuk berinteraksi dengan sumber daya. Semua PDF Operasi penandatanganan dilakukan melalui satu titik akhir:
- Metode: POST
- Titik akhir:
/api/v2/SignPdf
Didukung PDF Fitur Penandatanganan
Yang API menyediakan dukungan komprehensif untuk berbagai hal PDF kemampuan penandatanganan:
Dukungan Gambar Tanda Tangan
- Format Umum: Dukungan untuk JPG, PNGdan format gambar standar lainnya
- Base64 Pengkodean: Transmisi tanda tangan yang aman melalui Base64 pengkodean
- Ukuran FleksibelTersedia pilihan ukuran berdasarkan milimeter (10-200mm) dan piksel (20-600px).
- Pelestarian Kualitas: Mempertahankan kualitas gambar khas dalam PDF keluaran
Penempatan dan Tata Letak
- Penyelarasan HorizontalOpsi penempatan: Kiri, Tengah, dan Kanan
- Penyelarasan VertikalKontrol penempatan atas, tengah, dan bawah.
- Kontrol MarginPenentuan posisi yang tepat dengan pengukuran berbasis milimeter (0-100mm) dan piksel (0-300px).
- Penempatan FleksibelDukungan untuk posisi halaman apa pun dengan pengukuran yang tepat.
- Penargetan Halaman: Terapkan ke halaman tertentu atau seluruh dokumen (opsional)
Fitur Lanjutan
- Kontrol OpasitasTransparansi yang dapat disesuaikan (0-100) untuk tanda tangan yang halus atau mencolok
- Mode Latar BelakangOpsi untuk menempatkan tanda tangan di belakang atau di depan konten.
- Kontrol Cetak: Konfigurasikan tanda tangan agar muncul di tampilan dan dicetak atau hanya dicetak.
- Penampilan ProfesionalRendering tanda tangan berkualitas tinggi dengan visibilitas yang jelas.
REST API Parameter
Daftar lengkap parameter untuk Tanda PDF REST APIParameter-parameter tersebut diorganisir berdasarkan kategori untuk pemahaman dan implementasi yang lebih baik.
Penting: Parameter yang ditandai dengan tanda bintang (*) wajib diisi dan harus diberikan agar dapat digunakan. API agar berfungsi dengan benar.
Parameter yang Diperlukan
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| Nama dokumen* | String | Keluaran PDF nama file dengan ekstensi .pdf | output.pdf |
| Konten dokumen* | Base64 | PDF isi file yang dikodekan dalam Base64 | JVBERi... |
| File gambar* | Base64 | Konten file gambar tanda tangan dikodekan dalam Base64 | iVBORw0KGgoAAAANSUhEUgAA... |
| nama gambar* | String | Nama file gambar tanda tangan beserta ekstensinya (misalnya, .jpg, .png) | signature.jpg |
| alignX* | String | Penyelarasan horizontal: Kiri, Tengah, atau Benar | Right |
| sejajarkanY* | String | Penyelarasan vertikal: Atas, Tengah, atau Dasar | Bottom |
Parameter Opsional
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| halaman | String | Opsi halaman: "1", "1,3,5", "2-5", "1,3,7-10", "2-". Jika tidak ditentukan, berlaku untuk semua halaman | 1-3 |
| lebar dalam mm | String | Lebar tanda tangan dalam milimeter (10-200) | 50 |
| tinggi dalam mm | String | Tinggi tanda tangan dalam milimeter (10-200) | 25 |
| lebarInPx | String | Lebar tanda tangan dalam piksel (20-600) | 142 |
| tinggiInPx | String | Tinggi tanda tangan dalam piksel (20-600) | 71 |
| marginXInMM | String | Margin horizontal dalam milimeter (0-100) | 20 |
| marginYInMM | String | Margin vertikal dalam milimeter (0-100) | 20 |
| marginXInPx | String | Margin horizontal dalam piksel (0-300) | 57 |
| marginYInPx | String | Margin vertikal dalam piksel (0-300) | 57 |
| kegelapan | String | Opasitas (0-100): 0=tidak terlihat, 100=sangat buram | 100 |
| Tampilkan Hanya Dalam Cetak | Boolean | Tampilkan tanda tangan di layar dan cetak (benar) atau hanya cetak (salah) | true |
| latar belakang | Boolean | Tempatkan tanda tangan di latar belakang (benar) atau latar depan (salah) | false |
| asinkron | Boolean | Aktifkan pemrosesan asinkron. Saat true, itu API mengembalikan status 202 dan menyediakan polling URL di dalam Location judul | true |
Keluaran
Yang PDF4me Tanda PDF REST API Mengembalikan respons yang berbeda berdasarkan mode pemrosesan. API mengembalikan PDF sebagai Base64-string yang dikodekan dalam JSON format, bukan sebagai data biner.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Pemrosesan Sinkron (Default)
Kapan async tidak diatur atau diatur ke false, itu API memproses permintaan tersebut dengan segera:
Kode Status: 200 OK
Content-Type: application/json
Isi Tanggapan:
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}
Kolom Respons:
- Nama dokumen (string): Output PDF nama file
- Konten dokumen (string): The PDF berkas dengan tanda tangan ditambahkan, dikodekan sebagai Base64 rangkaian
Cara Penggunaan:
- Ekstrak
docContentlapangan dari JSON tanggapan - Uraikan kodenya Base64 string untuk mendapatkan biner PDF data
- Simpan atau proses PDF berkas sesuai kebutuhan
Contoh (JavaScript):
const response = await fetch(url, options);
const data = await response.json();
const pdfBytes = atob(data.docContent); // Decode Base64
// Save or process pdfBytes
Pemrosesan Asinkron
Kapan async: true sudah ditetapkan, API memproses permintaan secara asinkron:
Kode Status: 202 Accepted
Header Respons:
Location: https://api.pdf4me.com/api/v2/SignPdf/poll/12345-abcde-67890
Proses Pemungutan Suara:
- Ekstrak
Locationheader dari respons 202 - Jajak pendapat URL menggunakan GET permintaan
- Lanjutkan jajak pendapat hingga Anda menerima 200 OK status
- Jawaban terakhir berisi hal yang sama. JSON format dengan
docNameDandocContent(Base64)
Contoh Polling:
// Initial request returns 202 with Location header
const response = await fetch(url, options);
const location = response.headers.get('Location');
// Poll until complete
while (true) {
const pollResponse = await fetch(location, { headers: { 'Authorization': 'Basic ' + apiKey } });
if (pollResponse.status === 200) {
const data = await pollResponse.json();
// Process data.docContent (Base64 PDF)
break;
}
await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}
Respons Kesalahan
Yang API pengembalian standar HTTP Kode kesalahan beserta detail kesalahannya:
- Parameter permintaan tidak valid
- Kolom yang wajib diisi belum terisi (
Konten dokumen,Nama dokumen,File gambar,nama gambar,alignX,sejajarkanY) - Tidak sah Base64 pengkodean dalam
Konten dokumenatauFile gambar - Nilai perataan tidak valid (harus "Left", "Center", "Right" untuk alignX; "Top", "Middle", "Bottom" untuk alignY)
- Nilai ukuran tidak valid (lebar/tinggi harus berada dalam rentang yang ditentukan)
- Nilai opasitas tidak valid (harus antara 0-100)
- Tidak valid atau hilang API kunci
- API kunci tidak berfungsi dengan benar Base64 dikodekan dalam Authorization judul
- Hilang
Otorisasi: Dasarjudul
- Kesalahan pemrosesan sisi server
- PDF kegagalan pemrosesan
- Kegagalan penambahan tanda tangan
Format Respons Kesalahan:
{
"error": "Error message describing what went wrong"
}
Detail Format Respons
Penting: Yang API selalu kembali JSON, tidak pernah biner PDF data secara langsung.
Struktur Respons:
{
"docName": "string", // Output PDF filename
"docContent": "string" // Base64-encoded PDF content
}
Content-Type Judul:
- Kesuksesan:
application/json - Yang PDF tertanam sebagai Base64 tali di dalam JSON tanggapan
Mengapa Base64?
- JSON- Pengkodean aman untuk data biner
- Mudah ditransmisikan melalui HTTP
- Kompatibel dengan semua bahasa pemrograman
- Dapat langsung disematkan di JSON tanpa menghindari masalah
Mendekode Base64 ke PDF:
JavaScript/Node.js:
const base64 = response.docContent;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64').toString('binary'); // Node.js
Python:
import base64
pdf_bytes = base64.b64decode(response['docContent'])
with open('output.pdf', 'wb') as f:
f.write(pdf_bytes)
C#:
byte[] pdfBytes = Convert.FromBase64String(response.docContent);
File.WriteAllBytes("output.pdf", pdfBytes);
Contoh Permintaan
Judul
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Catatan:
- Dapatkan milikmu API kunci dari PDF4me Dasbor
- Yang API kunci harus Base64 dikodekan dan diawali dengan "Basic" di dalam Authorization judul
- Contoh: Jika Anda API kuncinya adalah
abc123, mengkodekannya menjadi Base64 dan menggunakanAuthorization: Basic YWJjMTIz
Muatan
Contoh Sederhana (Hanya Kolom yang Wajib Diisi):
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"imageFile": "iVBORw0KGgoAAAANSUhEUgAA...",
"imageName": "signature.jpg",
"alignX": "Right",
"alignY": "Bottom"
}
Contoh Lanjutan (Dengan Semua Kolom Opsional):
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"imageFile": "iVBORw0KGgoAAAANSUhEUgAA...",
"imageName": "signature.jpg",
"pages": "1-3",
"alignX": "Right",
"alignY": "Bottom",
"widthInMM": "50",
"heightInMM": "25",
"widthInPx": "142",
"heightInPx": "71",
"marginXInMM": "20",
"marginYInMM": "20",
"marginXInPx": "57",
"marginYInPx": "57",
"opacity": "100",
"showOnlyInPrint": true,
"isBackground": false,
"async": true
}
Contoh Kode
Yang PDF4me Tanda PDF REST API Menyediakan contoh kode dalam berbagai bahasa pemrograman. Pilih bahasa yang paling sesuai dengan lingkungan pengembangan Anda:
- C#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
Java Contoh
Java Implementasi dengan penanganan kesalahan dan pemrosesan respons yang lengkap:
JavaScript Contoh
Node.js dan kompatibel dengan browser JavaScript implementasi:
Google Script Contoh
Google Apps Script implementasi untuk Google Workspace integrasi:
PDF Fitur Penandatanganan
Kontrol Gambar Tanda Tangan
- Dukungan Format: JPG, PNG, GIF, dan format gambar standar lainnya
- Pelestarian KualitasMempertahankan kualitas dan resolusi gambar khas dalam PDF keluaran
- Base64 Pengkodean: Transmisi tanda tangan yang aman melalui Base64 pengkodean
- Ukuran FleksibelTersedia pilihan ukuran dalam milimeter dan piksel.
- Penampilan ProfesionalRendering tanda tangan berkualitas tinggi dengan visibilitas yang jelas.
Penempatan dan Tata Letak
- Kontrol PenyelarasanOpsi penyelarasan horizontal dan vertikal yang tepat
- Pengaturan Margin: Pemosisian berbasis milimeter dan piksel
- Penempatan Fleksibel: Mendukung posisi dan orientasi halaman apa pun
- Penargetan Halaman: Berlaku untuk halaman tertentu atau seluruh dokumen
- Kontrol UkuranDimensi yang dapat disesuaikan untuk penempatan optimal.
Fitur Lanjutan
- Kontrol OpasitasTransparansi yang dapat disesuaikan untuk tanda tangan yang halus atau mencolok
- Mode Latar BelakangOpsi untuk menempatkan tanda tangan di belakang atau di depan konten.
- Kontrol Cetak: Konfigurasikan tanda tangan agar hanya muncul dalam bentuk cetak atau di layar
- Hasil ProfesionalBuat tanda tangan yang meningkatkan otentikasi dan keamanan dokumen.
- Penempatan FleksibelKontrol perataan horizontal dan vertikal dengan akurasi setingkat piksel.
Studi Kasus & Aplikasi Industri
- Legal & Professional Services
- Finance & Banking
- Business & Enterprise
- Government & Compliance
Studi Kasus Layanan Hukum & Profesional
- Dokumentasi Hukum: Membubuhkan tanda tangan pada kontrak hukum, perjanjian, dan dokumen resmi.
- Penandatanganan KontrakTandatangani kontrak dan perjanjian secara digital untuk validitas hukum.
- Dokumen Pengadilan: Terapkan tanda tangan digital pada berkas pengadilan dan dokumen hukum
- Persyaratan KepatuhanMemenuhi persyaratan peraturan untuk penandatanganan dan otentikasi dokumen.
Studi Kasus Keuangan & Perbankan
- Penandatanganan Faktur: Menandatangani faktur dan pesanan pembelian secara digital
- Dokumen Keuangan: Membubuhkan tanda tangan pada laporan dan pernyataan keuangan
- Dokumen Pinjaman: Menandatangani perjanjian pinjaman dan dokumen keuangan secara digital
- Kepatuhan Regulasi: Memenuhi persyaratan peraturan untuk penandatanganan dokumen keuangan
Kasus Penggunaan Bisnis & Perusahaan
- Alur Kerja Bisnis: Menandatangani faktur, pesanan pembelian, dan dokumen bisnis secara digital
- Otentikasi DokumenTambahkan tanda tangan digital ke dokumen PDF untuk otentikasi dan verifikasi.
- Pembuatan LaporanTambahkan tanda tangan ke laporan dan dokumen resmi yang dihasilkan.
- Dokumentasi Perusahaan: Menandatangani dokumen perusahaan dan komunikasi resmi
Studi Kasus Pemerintahan & Kepatuhan
- Persyaratan KepatuhanMemenuhi persyaratan peraturan untuk penandatanganan dan otentikasi dokumen.
- Dokumen Pemerintah: Menerapkan tanda tangan digital pada dokumen dan formulir pemerintah
- Dokumentasi Regulasi: Menandatangani dokumen peraturan dan kepatuhan secara digital
- Catatan Publik: Membubuhkan tanda tangan pada catatan publik dan dokumen resmi