Lewati ke konten utama

Bandingkan Dokumen - Perbandingan Dokumen API

PDF4me Bandingkan Dokumen Memungkinkan Anda membandingkan dua dokumen Word dan melacak perubahan dengan opsi perbandingan yang komprehensif. Ini API Layanan ini memproses dua file Word dan menghasilkan dokumen perbandingan dengan pelacakan perubahan terperinci, pengaturan perbandingan yang dapat disesuaikan, manajemen revisi, dan laporan perbandingan profesional. API menerima isi dokumen melalui REST API panggilan, memanfaatkan Base64 Pengkodean untuk transmisi yang aman. Dengan kontrol penuh atas pemformatan, sensitivitas huruf besar/kecil, komentar, tabel, kolom, catatan kaki, kotak teks, dan header/footer, solusi ini ideal untuk peninjauan dokumen, kontrol versi, dan alur kerja pengeditan kolaboratif.

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.

Fitur Utama

  • Perbandingan DokumenBandingkan dua dokumen Word dan identifikasi semua perbedaannya.
  • Lacak Perubahan: Menghasilkan dokumen dengan pelacakan perubahan yang menunjukkan modifikasi
  • Opsi yang Dapat Disesuaikan: Mengontrol jenis perubahan apa yang akan dilacak atau diabaikan
  • Manajemen RevisiBersihkan revisi yang ada sebelum perbandingan.
  • Atribusi PenulisTetapkan perubahan kepada penulis tertentu untuk akuntabilitas.
  • Hasil Profesional: Menghasilkan dokumen perbandingan yang rapi dengan pelacakan revisi
  • Dukungan Berbagai Format: Bandingkan file .docx dan .doc
  • Penyaringan LanjutanAbaikan format, perubahan huruf besar/kecil, komentar, tabel, dan lainnya.

REST API Titik akhir

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

  • Metode: POST
  • Titik akhir: office/ApiV2Word/CompareDocuments

REST API Parameter

Daftar lengkap parameter untuk Membandingkan Dokumen 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

ParameterJenisKeteranganContoh
Dokumen pertama*ObjectReferensi dokumen pertama (dasar). Harus berisi Nama (string): nama dokumen dengan ekstensi (.docx, .doc). Dokumen ini berfungsi sebagai dasar perbandingan.{ "Name": "original.docx" }
firstDocContent*Base64Base64-Konten yang dienkode dari dokumen pertama. Harus berupa dokumen Word yang valid (.docx, .doc format)UEsDBBQABgAIAAAA...
Dokumen kedua*ObjectReferensi dokumen kedua (perbandingan). Harus memuat Nama (string): nama dokumen dengan ekstensi (.docx, .doc). Dokumen ini dibandingkan dengan yang pertama{ "Name": "modified.docx" }
Konten Dokumen Kedua*Base64Base64-Konten yang dienkode dari dokumen kedua. Harus berupa dokumen Word yang valid (.docx, .doc format)UEsDBBQABgAIAAAA...

Parameter Opsional (Opsi Perbandingan)

ParameterJenisKeteranganContoh
opsi perbandinganObjectPengaturan perbandingan. Properti: abaikanPemformatan (boolean), abaikan perubahan huruf besar/kecil (boolean), abaikan komentar (boolean), abaikanTabel (boolean), abaikan kolom (boolean), abaikan catatan kaki (boolean), abaikan kotak teks (boolean), abaikanHeaderDanFooter (boolean), pengarang (string). Lihat Opsi Perbandingan di bawah ini{ "ignoreFormatting": false, "author": "John Doe" }

Opsi Perbandingan

Yang API memberikan kontrol yang lebih rinci atas perubahan apa yang akan dilacak:

Opsi Konten:

  • abaikanPemformatanFokus pada konten teks, abaikan perubahan gaya.
  • abaikan perubahan huruf besar/kecilPerbandingan tidak peka huruf besar/kecil
  • abaikan komentarKecualikan perubahan komentar dari perbandingan.
  • abaikanTabel: Kecualikan perubahan struktur dan isi tabel
  • abaikan kolomKecualikan pembaruan kolom (konten yang diperbarui secara otomatis)

Opsi Elemen Dokumen:

  • abaikan catatan kaki: Kecualikan perubahan catatan kaki
  • abaikan kotak teksKecualikan perubahan kotak teks
  • abaikanHeaderDanFooter: Kecualikan perubahan header/footer

Sumber:

  • pengarang: Tetapkan nama penulis untuk perubahan yang dilacak dalam dokumen perbandingan

Keluaran

Yang PDF4me Bandingkan Dokumen 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.

Pemrosesan Sinkron (Default)

Yang API Memproses permintaan dan mengembalikan:

Kode Status: 200 OK

Tipe Konten: application/json

Isi Tanggapan:

{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "comparison-result.docx",
"success": true,
"errorMessage": null
}

Kolom Respons:

  • dokumen (string): Dokumen Word dengan perubahan yang dilacak yang menunjukkan semua perbedaan, dikodekan sebagai Base64 rangkaian
  • nama file (string): Nama file Word keluaran beserta hasil perbandingannya
  • kesuksesan (boolean): Menunjukkan apakah permintaan berhasil
  • pesan kesalahan (string atau null): Detail kesalahan jika keberhasilan bernilai false

Cara Penggunaan:

  1. Ekstrak document lapangan dari JSON tanggapan (Base64)
  2. Uraikan kodenya Base64 string untuk mendapatkan data biner dokumen Word
  3. Buka dokumen di Word untuk meninjau perubahan yang dilacak.
  4. Terima atau tolak perubahan 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 - document contains tracked changes

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):

{
"firstDocument": { "Name": "original.docx" },
"firstDocContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"secondDocument": { "Name": "modified.docx" },
"secondDocContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC..."
}

Contoh Lanjutan (Dengan Opsi Perbandingan):

{
"firstDocument": { "Name": "original.docx" },
"firstDocContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"secondDocument": { "Name": "modified.docx" },
"secondDocContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"comparisonOptions": {
"ignoreFormatting": false,
"ignoreCaseChanges": false,
"ignoreComments": true,
"ignoreTables": false,
"ignoreFields": true,
"ignoreFootnotes": false,
"ignoreTextboxes": false,
"ignoreHeadersAndFooters": false,
"author": "Legal Review System"
}
}

Contoh Perbandingan Hanya Berdasarkan Konten:

{
"firstDocument": { "Name": "original.docx" },
"firstDocContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"secondDocument": { "Name": "modified.docx" },
"secondDocContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"comparisonOptions": {
"ignoreFormatting": true,
"ignoreCaseChanges": true,
"ignoreComments": true,
"ignoreFields": true,
"author": "Content Review"
}
}

Contoh Kode

Yang PDF4me Bandingkan Dokumen REST API Menyediakan contoh kode dalam berbagai bahasa pemrograman. Pilih bahasa yang paling sesuai dengan lingkungan pengembangan Anda:

C# (CSharp) Contoh

Menyelesaikan C# Implementasi untuk membandingkan dokumen Word:

Studi Kasus & Aplikasi Industri

Studi Kasus Layanan Hukum & Profesional

  • Tinjauan KontrakBandingkan versi kontrak untuk mengidentifikasi perubahan dan modifikasi.
  • Pembaruan Dokumen HukumMelacak perubahan dalam berkas hukum, perjanjian, dan dokumen pengadilan.
  • Pemantauan KepatuhanBandingkan dokumen kebijakan untuk memastikan kepatuhan terhadap peraturan.
  • Peninjauan Dokumen KlienMelacak perubahan pada dokumen hukum yang ditujukan kepada klien.

Dapatkan Bantuan