Tambahkan Stempel Teks ke PDF - Tanda Air Teks API
PDF4me Tambahkan Stempel Teks ke PDF memungkinkan Anda menambahkan tanda air teks yang dapat disesuaikan ke PDF dokumen untuk otorisasi dan pencegahan pembajakan. Ini API proses layanan PDF file dan menambahkan stempel teks dengan kontrol atas teks, posisi, gaya, rotasi, dan tampilan. API menerima PDF konten melalui REST API panggilan, memanfaatkan Base64 Pengkodean untuk transmisi yang aman. Solusi ini ideal untuk branding dokumen, perlindungan hak cipta, indikator status, dan perusahaan. PDF alur kerja.
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
- Penempatan FleksibelKontrol perataan horizontal dan vertikal dengan akurasi setingkat piksel.
- Penataan Gaya KustomPilih dari berbagai jenis huruf, ukuran, warna, dan efek teks (tebal, miring, garis bawah)
- Pemformatan Lanjutan: Atur opsi opasitas, rotasi, margin, dan latar belakang
- Penargetan Halaman: Menempelkan stempel pada halaman tertentu atau seluruh dokumen
- Kontrol Cetak: Konfigurasikan stempel agar hanya muncul dalam bentuk cetak atau di layar
- Hasil ProfesionalBuat tanda air yang meningkatkan keamanan dan citra merek 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 operasi penambahan stempel teks dilakukan melalui satu titik akhir:
- Metode: POS
- Titik akhir:
/api/v2/Stamp
Fitur Stempel Teks yang Didukung
Yang API menyediakan dukungan komprehensif untuk berbagai kemampuan pemberian cap teks dan tanda air:
Opsi Kustomisasi Teks
- Pemilihan FontPilih dari font Arial, Times New Roman, Helvetica, atau Courier New.
- Kontrol UkuranUkuran font dapat disesuaikan dari 8 hingga 72
- Pilihan WarnaDukungan spektrum warna penuh dengan kode warna heksadesimal (misalnya, #FF0000 untuk warna merah)
- Efek TeksOpsi pemformatan: Tebal, miring, dan garis bawah
- Teks Kustom: Mendukung semua jenis teks, termasuk simbol dan karakter khusus
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 dan piksel.
- Dukungan RotasiRotasi teks: 0 (horizontal), 45 (diagonal), 90 (vertikal), -45 (diagonal terbalik)
- Penempatan FleksibelDukungan untuk posisi halaman apa pun dengan pengukuran yang tepat.
Fitur Lanjutan
- Kontrol OpasitasTransparansi yang dapat disesuaikan (0-100) untuk tanda air yang samar atau mencolok
- Mode Latar BelakangOpsi untuk menempatkan teks di belakang atau di depan konten.
- Kontrol Cetak: Konfigurasikan stempel agar muncul di tampilan dan dicetak atau hanya dicetak
- Penargetan Halaman: Berlaku untuk halaman tertentu atau seluruh dokumen
- Penyesuaian TeksPengaturan ukuran teks otomatis agar sesuai dengan batas halaman (opsional)
REST API Parameter
Daftar lengkap parameter untuk Menambahkan Stempel Teks ke 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* | Rangkaian | Keluaran PDF nama file dengan ekstensi .pdf | output.pdf |
| Konten dokumen* | Basis64 | PDF isi file yang dikodekan dalam Base64 | JVBERi... |
| halaman* | Rangkaian | Opsi halaman: "semua", "1", "1,3,5", "2-5", "1,3,7-10", "2-" | all |
| teks* | Rangkaian | Teks yang akan dicap sebagai tanda air | CONFIDENTIAL - PDF4me Watermark |
| alignX* | Rangkaian | Penyelarasan horizontal: kiri, tengah, atau Kanan | center |
| sejajarkanY* | Rangkaian | Penyelarasan vertikal: atas, tengah, atau dasar | middle |
Parameter Opsional
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| marginXInMM | Rangkaian | Margin horizontal dari tepi kiri dalam milimeter | 50 |
| marginYInMM | Rangkaian | Margin vertikal dari tepi atas dalam milimeter | 50 |
| marginXInPx | Rangkaian | Margin horizontal dari tepi kiri dalam piksel | 150 |
| marginYInPx | Rangkaian | Margin vertikal dari tepi atas dalam piksel | 150 |
| kegelapan | Rangkaian | Opasitas (0-100): 0=tidak terlihat, 100=sangat buram | 30 |
| nama font | Rangkaian | Nama font: Arial, Times New Roman, Helvetica, Kurir Baru | Arial |
| Ukuran huruf | Bilangan bulat | Ukuran huruf (8-72) | 24 |
| warna huruf | Rangkaian | Warna font dalam format heksadesimal (misalnya, #FF0000 untuk warna merah) | #FF0000 |
| Bola es | Boolean | Buat teks menjadi tebal (benar) atau biasa (salah) | true |
| dicetak miring | Boolean | Ubah teks menjadi miring (benar) atau normal (salah) | false |
| menggarisbawahi | Boolean | Garis bawahi teks (benar) atau tidak (salah) | false |
| memutar | Bilangan bulat | Sudut rotasi: 0 (horizontal), 45 (diagonal), 90 (vertikal), -45 (diagonal terbalik) | 45 |
| latar belakang | Boolean | Letakkan stempel di latar belakang (benar) atau latar depan (salah) | true |
| Tampilkan Hanya Dalam Cetak | Boolean | Tampilkan prangko dan cetak (salah) atau hanya cetak (benar) | false |
| melintang | Boolean | Posisi melintang (benar) atau normal (salah) | false |
| fitTextOverPage | Boolean | Sesuaikan teks agar memenuhi seluruh halaman (benar) atau gunakan ukuran yang ditentukan (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 Tambahkan Stempel Teks ke 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 stempel teks 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/Stamp/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,halaman,teks,alignX,sejajarkanY) - Tidak sah Base64 pengkodean dalam
Konten dokumen - Nilai perataan tidak valid (harus "left", "center", "right" untuk alignX; "top", "middle", "bottom" untuk alignY)
- Ukuran font tidak valid (harus antara 8-72)
- 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 stempel teks
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==",
"pages": "all",
"text": "CONFIDENTIAL - PDF4me Watermark",
"alignX": "center",
"alignY": "middle"
}
Contoh Lanjutan (Dengan Semua Kolom Opsional):
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"pages": "all",
"text": "CONFIDENTIAL - PDF4me Watermark",
"alignX": "center",
"alignY": "middle",
"marginXInMM": "50",
"marginYInMM": "50",
"marginXInPx": "150",
"marginYInPx": "150",
"opacity": "30",
"fontName": "Arial",
"fontSize": 24,
"fontColor": "#FF0000",
"isBold": true,
"isItalics": false,
"underline": false,
"rotate": 45,
"isBackground": true,
"showOnlyInPrint": false,
"transverse": false,
"fitTextOverPage": false,
"async": true
}
Contoh Kode
Yang PDF4me Tambahkan Stempel Teks ke 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
C# (CSharp) Contoh
Menyelesaikan C# implementasi untuk menambahkan stempel teks ke PDF:
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:
Fitur Pencetakan Teks
Opsi Kustomisasi
- Kontrol Font: Berbagai macam keluarga font dengan kustomisasi ukuran dan warna
- Efek TeksOpsi pemformatan: Tebal, miring, dan garis bawah
- Manajemen WarnaDukungan warna spektrum penuh dengan kode heksadesimal
- Isi Teks: Mendukung semua jenis teks termasuk simbol dan karakter khusus
- Penataan Gaya ProfesionalRendering teks berkualitas tinggi dengan visibilitas yang jelas.
Penempatan dan Tata Letak
- Kontrol PenyelarasanOpsi penyelarasan horizontal dan vertikal yang presisi
- Pengaturan Margin: Pemosisian berbasis milimeter dan piksel
- Dukungan Rotasi: Rotasi teks untuk watermark diagonal atau miring
- Penempatan Fleksibel: Mendukung posisi dan orientasi halaman apa pun
- Penargetan Halaman: Berlaku untuk halaman tertentu atau seluruh dokumen
Fitur Lanjutan
- Kontrol OpasitasTransparansi yang dapat disesuaikan untuk tanda air yang halus atau mencolok
- Mode Latar BelakangOpsi untuk menempatkan teks di belakang atau di depan konten.
- Kontrol Cetak: Konfigurasikan stempel agar hanya muncul dalam bentuk cetak atau di layar
- Penyesuaian Teks: Penyesuaian ukuran teks otomatis agar sesuai dengan batas halaman
- Mode TransversalTempelkan perangko di seluruh halaman.
Studi Kasus & Aplikasi Industri
- Legal & Professional Services
- Business & Enterprise
- Finance & Banking
- Government & Compliance
Studi Kasus Layanan Hukum & Profesional
- Dokumentasi Hukum: Terapkan pernyataan penafian hukum dan pemberitahuan kerahasiaan pada dokumen hukum
- Stempel KontrakTambahkan stempel status pada kontrak dan perjanjian.
- Pemberitahuan Kerahasiaan: Tempelkan stempel kerahasiaan pada dokumen hukum yang sensitif
- Stempel KepatuhanTambahkan pemberitahuan kepatuhan peraturan ke dokumen hukum.
Kasus Penggunaan Bisnis & Perusahaan
- Branding DokumenTambahkan logo perusahaan, tanda air, dan elemen merek ke dokumen PDF.
- Indikator StatusTambahkan stempel "DRAFT", "CONFIDENTIAL", atau "APPROVED" untuk menunjukkan status dokumen.
- Pembuatan LaporanTambahkan stempel waktu, nomor halaman, dan pengidentifikasi laporan ke dokumen yang dihasilkan.
- Pencitraan Merek PerusahaanTerapkan branding yang konsisten di seluruh dokumen bisnis.
Studi Kasus Keuangan & Perbankan
- Laporan KeuanganTambahkan stempel status pada laporan dan pernyataan keuangan.
- Stempel Faktur: Berikan stempel persetujuan pada faktur dan pesanan pembelian
- Dokumentasi KepatuhanTambahkan stempel peraturan pada dokumen keuangan.
- Jejak AuditBuat jejak audit dengan stempel waktu pada dokumen keuangan.
Studi Kasus Pemerintahan & Kepatuhan
- Perlindungan Hak Cipta: Cantumkan pemberitahuan hak cipta dan stempel kepemilikan untuk melindungi kekayaan intelektual
- Kepatuhan RegulasiTambahkan stempel kepatuhan untuk memenuhi persyaratan peraturan.
- Dokumentasi Resmi: Menempelkan stempel resmi pada dokumen pemerintah
- Catatan PublikTambahkan stempel klasifikasi pada catatan dan dokumen publik.