Menghapus Halaman dari Word - Manajemen Halaman API
PDF4me Menghapus Halaman dari Word Memungkinkan Anda untuk menghapus halaman tertentu atau rentang halaman dari dokumen Word dengan opsi pemilihan halaman yang fleksibel. Ini API Layanan ini memproses file Word dan menghapus halaman menggunakan penghapusan berbasis rentang (halaman awal hingga halaman akhir), penghapusan nomor halaman tertentu (daftar yang dipisahkan koma), dan pola penghapusan gabungan. API menerima konten dokumen Word melalui REST API panggilan, memanfaatkan Base64 Pengkodean untuk transmisi yang aman. Dengan dukungan untuk kontrol penuh atas pemilihan halaman, optimasi dokumen, dan pembersihan konten, solusi ini ideal untuk penyempurnaan dokumen, manajemen konten, dan alur kerja persiapan 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
- Pemilihan Halaman FleksibelHapus halaman berdasarkan rentang, nomor tertentu, atau kombinasi keduanya.
- Penghapusan Berdasarkan RentangHapus halaman-halaman berurutan dari halaman awal hingga halaman akhir.
- Penghapusan Halaman SpesifikHapus halaman satu per satu menggunakan nomor halaman yang dipisahkan koma.
- Optimalisasi DokumenBersihkan dokumen dengan menghapus konten yang tidak diinginkan.
- Pelestarian FormatPertahankan format dan struktur dokumen asli.
- Pelestarian Metadata: Pertahankan properti dokumen dan metadata kustom
- ValidasiValidasi nomor halaman otomatis dan penanganan kesalahan
- Dukungan Budaya: Pemrosesan dokumen khusus lokal
REST API Titik akhir
Yang PDF4me REST API menggunakan standar HTTP Metode untuk berinteraksi dengan sumber daya. Semua operasi penghapusan halaman dilakukan melalui satu titik akhir:
- Metode: POST
- Titik akhir:
office/ApiV2Word/DeletePages
REST API Parameter
Daftar lengkap parameter untuk Menghapus Halaman dari Word REST APIParameter-parameter tersebut diorganisir berdasarkan kategori untuk pemahaman dan implementasi yang lebih baik.
Penting: Parameter yang ditandai dengan tanda bintang (*) wajib diisi. Setidaknya satu parameter penghapusan halaman (startPage, endPage, atau pageNumbers) harus disediakan.
Parameter yang Diperlukan
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| dokumen* | Object | Referensi dokumen. Harus memuat Nama (string): Nama file Word dengan ekstensi .docx | { "Name": "document.docx" } |
| Konten dokumen* | Base64 | Konten dokumen Word yang dikodekan dalam Base64 | UEsDBBQABgAIAAAA... |
Parameter Opsional (Setidaknya satu diperlukan untuk penghapusan halaman)
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| Halaman Awal | Integer | Nomor halaman awal (indeks berbasis 1). Nomor halaman tempat penghapusan dimulai. Harus ≥ 1 dan ≤ jumlah halaman dokumen. Jika hanya startPage yang diberikan, penghapusan dilakukan dari halaman ini hingga akhir dokumen. Tidak boleh lebih besar dari endPage. | 2 |
| akhir halaman | Integer | Nomor halaman akhir (indeks berbasis 1). Nomor halaman tempat penghapusan dihentikan. Harus ≥ startPage dan ≤ jumlah halaman dokumen. Rentang bersifat inklusif (baik halaman awal maupun akhir dihapus). Dapat dikombinasikan dengan pageNumbers untuk pola penghapusan yang kompleks. | 5 |
| Nomor halaman | String | Daftar nomor halaman tertentu yang akan dihapus, dipisahkan dengan koma. Format: "1,3,4" atau "1-3,5,7-9". Dapat digunakan sendiri atau dikombinasikan dengan startPage/endPage. Nomor halaman yang tidak valid akan diabaikan tanpa pemberitahuan. Contoh: "2,4,6,8" menghapus halaman 2, 4, 6, dan 8. | "2,4,6" |
| nama budaya | String | Kode budaya untuk pemrosesan dokumen (misalnya, "en-US", "de-DE", "fr-FR"). Default: null (tidak ada pemrosesan khusus budaya). Mempengaruhi bahasa dan format dokumen. | en-US |
Mode Penghapusan Halaman
Yang API mendukung beberapa mode penghapusan halaman:
- Penghapusan Rentang: Menggunakan
startPageDanendPageuntuk menghapus halaman berurutan - Penghapusan Halaman Spesifik: Menggunakan
pageNumbersuntuk menghapus halaman individual - Penghapusan GabunganGunakan parameter rentang dan parameter halaman spesifik secara bersamaan.
- Hapus untuk MengakhiriHanya untuk digunakan
startPageuntuk menghapus dari halaman itu hingga akhir dokumen
Catatan: Semua nomor halaman berbasis 1 (halaman pertama = 1, bukan 0). Nomor halaman secara otomatis divalidasi terhadap jumlah halaman dokumen.
Keluaran
Yang PDF4me Menghapus Halaman dari Word REST API Mengembalikan respons yang berbeda berdasarkan mode pemrosesan. API mengembalikan dokumen Word sebagai Base64-string yang dikodekan dalam JSON format, bukan sebagai data biner.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Pemrosesan Sinkron (Default)
Yang API Memproses permintaan dan mengembalikan:
Kode Status: 200 OK
Tipe Konten: application/json
Isi Tanggapan:
{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "document.docx",
"success": true,
"errorMessage": null
}
Kolom Respons:
- dokumen (string): Dokumen Word dengan halaman tertentu yang dihapus, dikodekan sebagai Base64 rangkaian
- nama file (string): Nama file Word keluaran
- kesuksesan (boolean): Menunjukkan apakah permintaan berhasil
- pesan kesalahan (string atau null): Detail kesalahan jika keberhasilan bernilai false
Cara Penggunaan:
- Ekstrak
documentlapangan dari JSON tanggapan (Base64) - Uraikan kodenya Base64 string untuk mendapatkan data biner dokumen Word
- Simpan atau proses file Word sesuai kebutuhan.
Contoh (JavaScript):
const response = await fetch(url, options);
const data = await response.json();
const wordBytes = atob(data.document); // Decode Base64
// Save or process wordBytes
Pemrosesan Asinkron
Perilaku asinkron (202 Accepted (dengan polling) dikendalikan oleh konfigurasi server, bukan oleh parameter body permintaan. Saat diaktifkan, API dapat mengembalikan status 202 dengan polling URL di dalam Location Judul. Jajak pendapat URL dengan GET permintaan hingga Anda menerima 200 OK dengan bentuk respons yang sama (dokumen, nama file, sukses, pesan kesalahan).
Respons Kesalahan
Yang API pengembalian standar HTTP Kode kesalahan beserta detail kesalahannya:
- Parameter permintaan tidak valid
- Kolom yang wajib diisi belum terisi (
dokumendenganNama,Konten dokumen) - Setidaknya satu kriteria penghapusan halaman diperlukan (
Halaman Awal,akhir halaman, atauNomor halaman) - Tidak sah Base64 pengkodean dalam
Konten dokumen - Dokumen Word tidak valid atau rusak
Halaman Awaltidak mungkin lebih besar dariakhir halaman- Nomor halaman tidak valid (di luar rentang dokumen)
- Tidak valid atau hilang API kunci
- API kunci tidak berfungsi dengan benar Base64 dikodekan dalam Authorization judul
- Hilang
Otorisasi: Dasarjudul
- Kesalahan pemrosesan sisi server
- Kegagalan pemrosesan dokumen Word
- Penghapusan halaman gagal.
Format Respons Kesalahan:
{
"error": "Error message describing what went wrong"
}
Detail Format Respons
Penting: Yang API selalu kembali JSON, jangan pernah menggunakan data Word biner secara langsung.
Struktur Respons:
{
"document": "string", // Base64-encoded Word document content
"fileName": "string", // Output Word filename
"success": true,
"errorMessage": "string or null"
}
Header Content-Type:
- Kesuksesan:
application/json - Dokumen Word disematkan 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 Dokumen Word:
JavaScript/Node.js:
const base64 = response.document;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64'); // Node.js
Python:
import base64
word_bytes = base64.b64decode(response['document'])
with open('output.docx', 'wb') as f:
f.write(word_bytes)
C#:
byte[] wordBytes = Convert.FromBase64String(response.document);
File.WriteAllBytes("output.docx", wordBytes);
Contoh Penghapusan Halaman
Memahami berbagai pola penghapusan halaman:
| Halaman Dokumen | Halaman Awal | akhir halaman | Nomor halaman | Hasil |
|---|---|---|---|---|
| 1, 2, 3, 4, 5 | 2 | 4 | - | Simpanan: 1,5 |
| 1, 2, 3, 4, 5 | 3 | - | - | Simpanan: 1,2 |
| 1, 2, 3, 4, 5 | - | - | “2,4” | Simpanan: 1, 3, 5 |
| 1, 2, 3, 4, 5 | 2 | 3 | "5" | Jumlah yang disimpan: 1,4 |
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 (Penghapusan Rentang):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 4
}
Contoh Halaman Spesifik:
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"pageNumbers": "2,4,6,8"
}
Contoh Lanjutan (Penghapusan Gabungan):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 5,
"pageNumbers": "7,9",
"cultureName": "en-US"
}
Contoh Kode
Yang PDF4me Menghapus Halaman dari Word 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 menghapus halaman dari dokumen Word:
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:
Studi Kasus & Aplikasi Industri
- Legal & Professional Services
- Business & Enterprise
- Education & Research
- Finance & Banking
Studi Kasus Layanan Hukum & Profesional
- Pembersihan KontrakHapus halaman tanda tangan dan lampiran dari salinan kontrak.
- Persiapan Dokumen HukumHapus halaman-halaman rahasia sebelum didistribusikan kepada klien.
- Optimalisasi Pengajuan Dokumen PengadilanHapus halaman yang tidak perlu untuk memenuhi persyaratan pengarsipan.
- Versi Dokumen KlienBuat versi bersih dengan menghapus catatan internal.
Kasus Penggunaan Bisnis & Perusahaan
- Optimalisasi ProposalHapus halaman biaya internal dari proposal klien.
- Pembersihan Materi PemasaranHapus halaman konten yang sudah usang dari materi yang ada.
- Persiapan PresentasiHapus slide dan catatan cadangan dari presentasi akhir.
- Optimalisasi Hasil yang Disampaikan kepada KlienBuat versi bersih dengan menghapus referensi internal.
Studi Kasus Pendidikan & Penelitian
- Pembersihan Laporan MedisHapus halaman informasi pasien yang sensitif.
- Optimalisasi Dokumen PenelitianHapus data pendahuluan dari laporan akhir.
- Persiapan Dokumen ProtokolHapus halaman tinjauan internal dari protokol yang telah dipublikasikan.
- Dokumentasi Kepatuhan: Merapikan dokumen untuk pengajuan regulasi
Studi Kasus Keuangan & Perbankan
- Pembersihan Laporan KeuanganHapus lampiran rinci dari ringkasan eksekutif.
- Optimalisasi Dokumen AnggaranHapus halaman data historis dari anggaran saat ini
- Penyusunan Laporan AuditHapus halaman internal yang sensitif sebelum didistribusikan ke luar.
- Pembersihan Pengajuan RegulasiOptimalkan dokumen agar memenuhi persyaratan pengajuan.