Tambahkan Nomor Halaman ke PDF - Penomoran Halaman API

PDF4me Tambahkan Nomor Halaman ke PDF memungkinkan Anda menambahkan nomor halaman yang dapat disesuaikan ke PDF dokumen dengan kendali atas posisi, format, dan gaya. Ini API proses layanan PDF file dan menambahkan nomor halaman menggunakan placeholder format di mana # mewakili nomor halaman saat ini dan {1} mewakili jumlah total halaman. API menerima PDF konten melalui REST API panggilan, memanfaatkan Base64 Pengkodean untuk transmisi yang aman. Solusi ini ideal untuk pengorganisasian dokumen, dokumentasi hukum, makalah akademis, 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.

Dapatkan kunci API Anda

Fitur Utama

• Pemformatan FleksibelPilih dari berbagai format nomor halaman menggunakan # untuk halaman saat ini dan {1} untuk jumlah total halaman (misalnya, "# dari 1", "Halaman #")
• Penentuan Posisi yang TepatKontrol perataan horizontal dan vertikal dengan akurasi setingkat piksel.
• Penataan Gaya KustomSesuaikan ukuran font, tebal, miring, dan opsi pemformatan teks lainnya.
• Kontrol MarginAtur margin yang tepat dalam milimeter untuk penempatan optimal.
• Lewati Halaman PertamaOpsi untuk tidak menampilkan nomor halaman di halaman pertama.
• Hasil ProfesionalBuat penomoran halaman yang konsisten dan profesional di seluruh dokumen.

REST API Titik akhir

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

• Metode: POS
• Titik akhir: /api/v2/AddPageNumber

REST API Parameter

Daftar lengkap parameter untuk Menambahkan Nomor Halaman 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...
Nomor halaman Format*	Rangkaian	Format nomor halaman. Gunakan # untuk nomor halaman saat ini, {1} untuk jumlah total halaman. Contoh: "# dari 1", "Halaman #", "# / 1"	# of {1}
alignX*	Rangkaian	Penyelarasan horizontal: kiri, tengah, atau Kanan	right
sejajarkanY*	Rangkaian	Penyelarasan vertikal: atas, tengah, atau dasar	bottom

Parameter Opsional

Parameter	Jenis	Keterangan	Contoh
marginXinMM	Bilangan bulat	Margin horizontal dari tepi dalam milimeter (0-100)	2
marginInMM	Bilangan bulat	Margin vertikal dari tepi dalam milimeter (0-100)	2
Ukuran huruf	Bilangan bulat	Ukuran font untuk nomor halaman (8-72)	12
Bola es	Boolean	Buat nomor halaman menjadi tebal (benar) atau biasa (salah)	true
miring	Boolean	Buat nomor halaman menjadi miring (benar) atau normal (salah)	false
Lewati halaman pertama	Boolean	Lewati penomoran pada halaman pertama (benar) atau sertakan (salah)	false
asinkron	Boolean	Aktifkan pemrosesan asinkron. Saat true, itu API mengembalikan status 202 dan menyediakan polling URL di dalam Location judul	true

Placeholder Format Nomor Halaman

Yang pageNumberFormat Parameter ini menggunakan placeholder berikut:

• # - Diganti dengan nomor halaman saat ini (1, 2, 3, dst.)
• {1} - Diganti dengan jumlah total halaman

Contoh Format:

• "# of {1}" → Menampilkan "1 dari 10", "2 dari 10", "3 dari 10", dan seterusnya.
• "Page #" → Menampilkan "Halaman 1", "Halaman 2", "Halaman 3", dst.
• "# / {1}" → Menampilkan "1 / 10", "2 / 10", "3 / 10", dst.
• "- # -" → Menampilkan "- 1 -", "- 2 -", "- 3 -", dst.
• "[#/{1}]" → Menampilkan "[1/10]", "[2/10]", "[3/10]", dan seterusnya.
• "(#)" → Menampilkan "(1)", "(2)", "(3)", dan seterusnya.
• "#" → Hanya menampilkan nomor halaman: "1", "2", "3", dst.

Keluaran

Yang PDF4me Tambahkan Nomor Halaman 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 nomor halaman ditambahkan, 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/AddPageNumber/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 (Konten dokumen, Nama dokumen, Format NomorHalaman, 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 margin tidak valid (harus berupa bilangan bulat antara 0-100)

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 penambahan nomor halaman

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==",
  "pageNumberFormat": "# of {1}",
  "alignX": "right",
  "alignY": "bottom"
}

Contoh Lanjutan (Dengan Semua Kolom Opsional):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "pageNumberFormat": "# of {1}",
  "alignX": "right",
  "alignY": "bottom",
  "marginXinMM": 2,
  "marginYinMM": 2,
  "fontSize": 12,
  "isBold": true,
  "isItalic": false,
  "skipFirstPage": false,
  "async": true
}

Contoh Kode

Yang PDF4me Tambahkan Nomor Halaman 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 nomor halaman 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 implementasi dengan Apex Dan HTTP panggilan:

View Salesforce Sample

n8n

n8n Contoh

n8n implementasi alur kerja dengan HTTP node permintaan:

View n8n Sample

Google Script

Google Script Contoh

Google Apps Script Implementasi dengan UrlFetchApp:

View Google Script Sample

AWS Lambda

AWS Lambda Contoh

AWS Lambda implementasi dengan Node.js Dan API Gerbang:

View AWS Lambda Sample

Fitur Nomor Halaman

Opsi Pemformatan

• Berbagai FormatDukungan untuk berbagai gaya dan pola penomoran
• Penempatan FleksibelKontrol yang tepat atas penempatan nomor halaman
• Penataan Gaya KustomKontrol penuh atas tampilan dan format font.
• Kontrol Halaman PertamaOpsi untuk mengecualikan halaman sampul dari penomoran.

Peningkatan Dokumen

• Tata Letak ProfesionalBuat penomoran halaman yang konsisten dan profesional di seluruh dokumen.
• Optimasi PencetakanOptimalkan jumlah halaman untuk berbagai kebutuhan pencetakan.
• Distribusi Digital: Pertahankan format di berbagai perangkat tampilan
• Konsistensi MerekTerapkan standar penomoran halaman yang seragam di seluruh organisasi.

Fitur Lanjutan

• Pemrosesan Batch: Memproses banyak dokumen dengan penomoran halaman yang konsisten
• Jaminan MutuPastikan integritas nomor halaman dan kebenarannya PDF kompatibilitas
• Pelestarian Tata LetakPertahankan struktur dokumen sambil menambahkan nomor halaman.
• Margin KustomKontrol yang tepat atas penempatan nomor halaman

Studi Kasus & Aplikasi Industri

Legal & Professional Services

Studi Kasus Layanan Hukum & Profesional

• Dokumentasi Hukum: Memberi nomor halaman dalam kontrak, perjanjian, dan dokumen hukum
• Dokumen PengadilanTambahkan nomor halaman pada berkas pengadilan dan dokumen hukum.
• Dokumentasi Kepatuhan: Penomoran halaman dalam dokumen kepatuhan dan peraturan
• Dokumentasi Klien: Mengatur dokumen klien dengan penomoran halaman

Education & Research

Studi Kasus Pendidikan & Penelitian

• Makalah Akademik: Format makalah penelitian dan tesis dengan penomoran halaman yang tepat
• Dokumen Penelitian: Menambahkan nomor halaman pada makalah penelitian dan publikasi
• Pemformatan Tesis: Penomoran halaman dalam tesis dan disertasi
• Materi PendidikanSusun dokumen pendidikan dengan nomor halaman.

Business & Enterprise

Kasus Penggunaan Bisnis & Perusahaan

• Laporan BisnisBuat laporan profesional dengan penomoran halaman yang konsisten.
• Pengorganisasian DokumenTambahkan nomor halaman pada laporan, manual, dan dokumen teknis.
• Manual TeknisSusun dokumentasi teknis dengan referensi halaman yang jelas.
• Dokumentasi Perusahaan: Memberi nomor halaman dalam dokumen dan manual perusahaan

Government & Compliance

Studi Kasus Pemerintahan & Kepatuhan

• Dokumen ArsipSiapkan dokumen untuk penyimpanan jangka panjang dengan nomor halaman.
• Laporan PemerintahTambahkan nomor halaman pada laporan dan dokumen pemerintah.
• Dokumentasi Regulasi: Penomoran halaman dalam dokumen peraturan dan kepatuhan
• Catatan Publik: Mengatur arsip publik dengan penomoran halaman

Dapatkan Bantuan

Get Your API KeyAPI SamplesGetting Started