Tambahkan Stempel Gambar ke PDF - Tanda air API

PDF4me Tambahkan Stempel Gambar ke PDF memungkinkan Anda menambahkan stempel gambar dan tanda air yang dapat disesuaikan ke PDF dokumen. Ini API proses layanan PDF Mengolah file dan menambahkan watermark gambar dengan penempatan yang tepat, ukuran khusus, dan opsi pemformatan untuk branding dan keamanan dokumen. API menerima PDF data konten dan gambar melalui REST API panggilan, memanfaatkan Base64 Pengkodean untuk transmisi yang aman. Dengan dukungan untuk pen positioning yang fleksibel, ukuran khusus, penargetan halaman, dan kontrol pencetakan, solusi ini ideal untuk branding dokumen, perlindungan hak cipta, dan perusahaan. PDF alur kerja.

Postingan Blog Terkait

Belum ada postingan blog untuk fitur ini — akan segera hadir.

Sementara itu, jelajahi blog PDF4me untuk menemukan tutorial dan alur kerja di berbagai platform.

Kunjungi blog ini →

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.

Get your api Key

Fitur Utama

• Dukungan Tanda Air GambarTambahkan gambar khusus sebagai tanda air dan stempel ke PDF dokumen
• Penempatan FleksibelKontrol perataan horizontal dan vertikal dengan akurasi setingkat piksel.
• Ukuran KhususSesuaikan dimensi gambar menggunakan pengukuran milimeter dan piksel.
• Pemformatan LanjutanAtur opasitas, margin, dan opsi latar belakang untuk tampilan profesional.
• 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 gambar yang meningkatkan keamanan dan branding dokumen.
• Tanpa sambungan API Integrasi: REST API dirancang untuk otomatis PDF pengeditan alur kerja dan integrasi sistem perusahaan

REST API Titik akhir

Yang PDF4me REST API menggunakan standar HTTP Metode untuk berinteraksi dengan sumber daya. Semua operasi penambahan stempel gambar dilakukan melalui satu titik akhir:

• Metode: POST
• Titik akhir: /api/v2/ImageStamp

Fitur Pencetakan Gambar

Dukungan Format Gambar

• Format Umum: Dukungan untuk JPG, PNG, GIF, dan format gambar standar lainnya
• Base64 Pengkodean: Transmisi gambar yang aman melalui Base64 pengkodean
• Kontrol UkuranTersedia pilihan ukuran dalam milimeter (10-200mm) dan piksel (20-600px).

Penempatan dan Tata Letak

• Penyelarasan HorizontalOpsi penempatan: Kiri, Tengah, atau Kanan
• Penyelarasan VertikalKontrol penempatan: Atas, Tengah, atau Bawah
• Kontrol MarginPenentuan posisi yang tepat dengan pengukuran milimeter (0-100mm) dan berbasis piksel (0-300px)
• Penargetan Halaman: Terapkan ke halaman tertentu menggunakan opsi halaman (string kosong untuk semua halaman, "1", "1,3,5", "2-5", "1,3,7-10", "2-")

Fitur Lanjutan

• Kontrol OpasitasTransparansi yang dapat disesuaikan (0-100): 0=tidak terlihat, 100=buram sepenuhnya
• Mode Latar Belakang: Opsi untuk menempatkan gambar di belakang (isBackground: true) atau di depan (isBackground: false) konten
• Kontrol Cetak: Konfigurasikan stempel agar hanya muncul dalam bentuk cetak (showOnlyInPrint: true) atau dalam tampilan dan cetak (showOnlyInPrint: false)
• Pemrosesan AsinkronDukungan untuk pemrosesan asinkron dengan polling untuk operasi yang berjalan lama.

REST API Parameter

Daftar lengkap parameter untuk Menambahkan Stempel Gambar 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*	String	Keluaran PDF nama file dengan ekstensi .pdf	output.pdf
Konten dokumen*	Base64	Isi dari input PDF berkas yang dikodekan dalam Base64	JVBERi...
nama gambar*	String	Nama file gambar beserta ekstensinya (misalnya, .png, .jpg)	stamp.png
File gambar*	Base64	Konten berkas gambar dikodekan dalam Base64 format	iVBORw0KGgoAAAANS...
alignX*	String	Penyelarasan horizontal: Kiri, Tengah, atau Benar	Center
sejajarkanY*	String	Penyelarasan vertikal: Atas, Tengah, atau Dasar	Middle

Parameter Opsional

Parameter	Jenis	Keterangan	Contoh
halaman	String	Opsi halaman: string kosong untuk semua halaman, "1" untuk halaman 1, "1,3,5" untuk halaman tertentu, "2-5" untuk rentang halaman, "1,3,7-10" untuk campuran, "2-" untuk halaman 2 sampai akhir	"" atau "1-3"
tinggi dalam mm	String	Tinggi gambar dalam milimeter (10-200)	30
lebar dalam mm	String	Lebar gambar dalam milimeter (10-200)	30
tinggiInPx	String	Tinggi gambar dalam piksel (20-600)	85
lebarInPx	String	Lebar gambar dalam piksel (20-600)	85
marginXInMM	String	Margin horizontal dalam milimeter (0-100)	10
marginYInMM	String	Margin vertikal dalam milimeter (0-100)	10
marginXInPx	String	Margin horizontal dalam piksel (0-300)	28
marginYInPx	String	Margin vertikal dalam piksel (0-300)	28
kegelapan	Integer	Tingkat keburaman (0-100): 0=tidak terlihat, 100=sangat buram	50
latar belakang	Boolean	Letakkan stempel di latar belakang (benar) atau latar depan (salah)	true
Tampilkan Hanya Dalam Cetak	Boolean	Hanya ditampilkan dalam bentuk cetak (benar) atau dalam tampilan dan cetak (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 Gambar 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

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 gambar yang diterapkan, dikodekan sebagai Base64 rangkaian

Cara Penggunaan:

1. Ekstrak docContent lapangan dari JSON tanggapan
2. Uraikan kodenya Base64 string untuk mendapatkan biner PDF data
3. 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

Asynchronous Processing

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/ImageStamp/poll/12345-abcde-67890

Proses Pemungutan Suara:

1. Ekstrak Location header dari respons 202
2. Jajak pendapat URL menggunakan GET permintaan
3. Lanjutkan jajak pendapat hingga Anda menerima 200 OK status
4. Jawaban terakhir berisi hal yang sama. JSON format dengan docName Dan docContent (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
}

Error Responses

Respons Kesalahan

Yang API pengembalian standar HTTP Kode kesalahan beserta detail kesalahannya:

400 Bad Request

• Parameter permintaan tidak valid
• Kolom yang wajib diisi belum terisi (Nama dokumen, Konten dokumen, nama gambar, File gambar, alignX, sejajarkanY)
• Tidak sah Base64 pengkodean dalam Konten dokumen atau File gambar
• Nilai perataan tidak valid (harus: Kiri/Tengah/Kanan untuk alignX, Atas/Tengah/Bawah untuk alignY)
• Nilai ukuran atau margin tidak valid (di luar rentang yang diizinkan)

401 Unauthorized

• Tidak valid atau hilang API kunci
• API kunci tidak berfungsi dengan benar Base64 dikodekan dalam Authorization judul
• Hilang Otorisasi: Dasar judul

500 Internal Server Error

• Kesalahan pemrosesan sisi server
• PDF kegagalan pemrosesan
• Kegagalan aplikasi stempel gambar

Format Respons Kesalahan:

{
  "error": "Error message describing what went wrong"
}

Response Format Details

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 menggunakan Authorization: Basic YWJjMTIz

Muatan

Contoh Sederhana (Hanya Kolom yang Wajib Diisi):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageName": "stamp.png",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "alignX": "Center",
  "alignY": "Middle"
}

Contoh Lanjutan (Dengan Semua Kolom Opsional):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageName": "stamp.png",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "alignX": "Center",
  "alignY": "Middle",
  "pages": "",
  "heightInMM": "30",
  "widthInMM": "30",
  "heightInPx": "85",
  "widthInPx": "85",
  "marginXInMM": "10",
  "marginYInMM": "10",
  "marginXInPx": "28",
  "marginYInPx": "28",
  "opacity": 50,
  "isBackground": true,
  "showOnlyInPrint": false,
  "async": true
}

Contoh Kode

Yang PDF4me Tambahkan Stempel Gambar ke PDF REST API Menyediakan contoh kode dalam berbagai bahasa pemrograman. Pilih bahasa yang paling sesuai dengan lingkungan pengembangan Anda:

C#

C# (CSharp) Contoh

Menyelesaikan C# implementasi untuk menambahkan stempel gambar ke PDF:

View C# Sample

Java

Java Contoh

Java Implementasi dengan penanganan kesalahan dan pemrosesan respons yang lengkap:

View Java Sample

JavaScript

JavaScript Contoh

Node.js dan kompatibel dengan browser JavaScript implementasi:

View JavaScript Sample

Python

Python Contoh

Python implementasi dengan pustaka permintaan dan JSON penanganan:

View Python Sample

Salesforce

Salesforce Contoh

Salesforce Apex implementasi untuk CRM integrasi:

View Salesforce Sample

n8n

n8n Contoh

n8n Implementasi alur kerja untuk otomatisasi:

View n8n Sample

Google Script

Google Script Contoh

Google Apps Script implementasi untuk Google Workspace integrasi:

View Google Script Sample

AWS Lambda

AWS Lambda Contoh

Tanpa server AWS Lambda implementasi fungsi:

View AWS Lambda Sample

Studi Kasus & Aplikasi Industri

Legal & Professional Services

Studi Kasus Layanan Hukum & Profesional

• Dokumentasi Hukum: Terapkan pernyataan penafian hukum dan pemberitahuan kerahasiaan pada dokumen hukum
• Stempel KontrakTambahkan stempel gambar ke kontrak dan perjanjian.
• Pemberitahuan Kerahasiaan: Gunakan stempel gambar kerahasiaan pada dokumen hukum yang sensitif
• Stempel KepatuhanTambahkan pemberitahuan gambar kepatuhan peraturan ke dokumen hukum.

Business & Enterprise

Kasus Penggunaan Bisnis & Perusahaan

• Branding DokumenTambahkan logo perusahaan, tanda air, dan elemen merek ke dokumen PDF.
• Indikator StatusTambahkan stempel gambar "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 citra yang konsisten di seluruh dokumen bisnis.

Finance & Banking

Studi Kasus Keuangan & Perbankan

• Laporan KeuanganTambahkan stempel gambar ke laporan dan pernyataan keuangan.
• Stempel Faktur: Berikan stempel persetujuan gambar pada faktur dan pesanan pembelian
• Dokumentasi KepatuhanTambahkan stempel gambar regulasi ke dokumen keuangan.
• Jejak AuditBuat jejak audit dengan stempel waktu gambar pada dokumen keuangan.

Government & Compliance

Studi Kasus Pemerintahan & Kepatuhan

• Perlindungan Hak Cipta: Terapkan pemberitahuan hak cipta dan stempel kepemilikan gambar untuk melindungi kekayaan intelektual
• Kepatuhan RegulasiTambahkan stempel gambar kepatuhan untuk memenuhi persyaratan peraturan.
• Dokumentasi Resmi: Menempelkan stempel gambar resmi pada dokumen pemerintah
• Catatan PublikTambahkan stempel gambar klasifikasi ke catatan dan dokumen publik.

Dapatkan Bantuan

Get Your API KeyAPI SamplesGetting Started