Tambahkan Margin ke PDF - Pemformat Tata Letak API
PDF4me Tambahkan Margin ke PDF memungkinkan Anda menambahkan margin khusus ke sisi mana pun dari PDF dokumen ini. Ini API proses layanan PDF File tersebut menambahkan margin dalam milimeter, menyesuaikan ukuran halaman agar sesuai dengan margin tersebut. API menerima PDF konten melalui REST API panggilan, memanfaatkan Base64 Pengkodean untuk transmisi yang aman. Solusi ini ideal untuk pemformatan dokumen, persiapan cetak, dan memastikan tata letak halaman yang konsisten untuk dokumen profesional.
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
- Kontrol Margin IndividuAtur margin yang berbeda untuk sisi atas, bawah, kiri, dan kanan secara terpisah.
- Presisi MilimeterSemua margin ditentukan dalam milimeter (rentang 0-100)
- Penyesuaian Ukuran HalamanUkuran halaman secara otomatis disesuaikan untuk mengakomodasi margin tambahan.
- Pelestarian DokumenMempertahankan konten asli sambil menyesuaikan tata letak.
- 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 margin dilakukan melalui satu titik akhir:
- Metode: POST
- Titik akhir:
/api/v2/AddMargin
REST API Parameter
Daftar lengkap parameter untuk Menambahkan Margin 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 | PDF isi file yang dikodekan dalam Base64 | JVBERi... |
Parameter Opsional
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| marginKiri | Integer | Margin kiri dalam milimeter (0-100). Jika tidak ditentukan, margin kiri tidak ditambahkan. | 20 |
| marginKanan | Integer | Margin kanan dalam milimeter (0-100). Jika tidak ditentukan, tidak ada margin kanan yang ditambahkan. | 20 |
| marginAtas | Integer | Margin atas dalam milimeter (0-100). Jika tidak ditentukan, tidak ada margin atas yang ditambahkan. | 25 |
| marginBottom | Integer | Margin bawah dalam milimeter (0-100). Jika tidak ditentukan, tidak ada margin bawah yang ditambahkan. | 25 |
| 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 Margin 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 margin 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/AddMargin/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) - Tidak sah Base64 pengkodean dalam
Konten dokumen - Nilai margin tidak valid (harus berupa bilangan bulat 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 margin
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=="
}
Contoh Lanjutan (Dengan Semua Kolom Opsional):
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"marginLeft": 20,
"marginRight": 20,
"marginTop": 25,
"marginBottom": 25,
"async": true
}
Contoh Kode
Yang PDF4me Tambahkan Margin 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
Java Contoh
Java Implementasi dengan penanganan kesalahan dan pemrosesan respons yang lengkap:
JavaScript Contoh
Node.js dan kompatibel dengan browser JavaScript implementasi:
PDF Fitur Margin
Kontrol Margin
- Kontrol IndividuAtur margin yang berbeda untuk setiap sisi dokumen (atas, bawah, kiri, kanan)
- Presisi MilimeterSemua margin ditentukan dalam milimeter dengan rentang 0-100.
- Penyesuaian Ukuran HalamanUkuran halaman secara otomatis disesuaikan untuk mengakomodasi margin tambahan.
- Pelestarian Tata LetakPertahankan struktur dokumen sambil menyesuaikan margin.
Peningkatan Dokumen
- Optimasi PencetakanPastikan dokumen tercetak dengan benar pada berbagai ukuran kertas.
- Pemformatan ProfesionalBuat tata letak dokumen yang konsisten di seluruh tim.
- Pelestarian Konten: Asli PDF Konten dipertahankan sementara margin ditambahkan.
Studi Kasus & Aplikasi Industri
- Legal & Professional Services
- Education & Research
- Business & Enterprise
- Publishing & Printing
Studi Kasus Layanan Hukum & Profesional
- Dokumen Hukum: Pastikan kepatuhan terhadap standar format dokumen hukum
- Pemformatan Kontrak: Format kontrak dan perjanjian dengan margin yang sesuai
- Dokumen PengadilanSiapkan dokumen pengadilan dengan persyaratan margin standar.
- Dokumentasi Kepatuhan: Memformat dokumen kepatuhan agar memenuhi standar peraturan
Studi Kasus Pendidikan & Penelitian
- Makalah Akademik: Memformat makalah penelitian dan tesis agar memenuhi persyaratan publikasi
- Dokumen Penelitian: Format makalah penelitian dengan margin yang tepat untuk publikasi
- Pemformatan Tesis: Memformat tesis dan disertasi agar memenuhi standar akademik
- Materi Pendidikan: Format dokumen pendidikan dengan margin yang konsisten
Kasus Penggunaan Bisnis & Perusahaan
- Pemformatan Dokumen: Standarisasi margin di seluruh dokumen perusahaan
- Laporan BisnisBuat laporan profesional dengan tata letak yang konsisten.
- Materi presentasi: Meningkatkan daya tarik visual dokumen presentasi
- Dokumentasi PerusahaanFormat dokumen perusahaan dengan margin standar.
Studi Kasus Penerbitan & Percetakan
- Persiapan PencetakanOptimalkan PDF untuk kebutuhan pencetakan tertentu.
- Pemformatan Buku: Menata buku dan publikasi dengan margin yang tepat
- Tata Letak Majalah: Siapkan tata letak majalah dengan margin standar
- Produksi CetakOptimalkan dokumen untuk kebutuhan produksi cetak.