Lewati ke konten utama
API PDF4meIntegrasiBasis PengetahuanEkstensiPenguji APIBlog

Ganti Teks - Penggantian Teks API

PDF4me Ganti Teks Memungkinkan Anda untuk mencari dan mengganti teks dalam dokumen Word dengan opsi pencarian tingkat lanjut. Ini API Layanan ini memproses file Word dan melakukan beberapa operasi penggantian dengan pencocokan peka huruf besar/kecil dan pencocokan kata utuh. API menerima konten dokumen Word melalui REST API panggilan, memanfaatkan Base64 Pengkodean untuk transmisi yang aman. Dengan dukungan untuk beberapa operasi pencarian dan penggantian dalam satu permintaan, solusi ini ideal untuk otomatisasi dokumen, pemrosesan templat, dan alur kerja manajemen konten.

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​

  • Penggantian Teks BergandaLakukan beberapa operasi pencarian dan penggantian dalam satu tindakan.
  • Opsi Pencarian LanjutanPencocokan peka huruf besar/kecil dan pencocokan kata utuh
  • Pemrosesan BerurutanBeberapa penggantian diproses sesuai urutan yang ditentukan.
  • Pencocokan Fleksibel: Pencocokan persis, pencocokan sebagian, atau pencocokan kata utuh
  • Struktur SederhanaSerangkaian operasi pencarian dan penggantian yang mudah digunakan.

REST API Titik akhir​

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

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

REST API Parameter​

Daftar lengkap parameter untuk Penggantian Teks REST APIParameter-parameter tersebut diorganisir berdasarkan kategori untuk pemahaman dan implementasi yang lebih baik.

Penting: Parameter yang ditandai dengan tanda bintang (*) wajib diisi. Parameter tersebut frasa Larik tersebut harus berisi setidaknya satu frasa pengganti.

Parameter yang Diperlukan​

ParameterJenisKeteranganContoh
dokumen*ObjectReferensi dokumen. Harus memuat Nama (string): Nama file Word dengan ekstensi .docx{ "Name": "document.docx" }
Konten dokumen*Base64Konten dokumen Word yang dikodekan dalam Base64Penggantian teks dilakukan pada dokumen ini.UEsDBBQABgAIAAAA...
frasa*ArrayArray objek pengganti. Harus berisi setidaknya satu pengganti. Setiap pengganti diproses secara berurutan sesuai urutan yang ditentukan.Lihat contoh di bawah ini.

Struktur Objek Penggantian Teks (susunan frasa)​

Setiap item dalam frasa Array harus berupa objek dengan struktur berikut:

ParameterJenisKeteranganContoh
temukanTeks*StringString teks yang akan dicari dalam dokumen. Tidak boleh null atau kosong. Peka terhadap huruf besar/kecil atau tidak peka terhadap huruf besar/kecil berdasarkan pengaturan matchCase. Semua kemunculan teks ini akan diganti."old text"
gantiTeksStringTeks yang akan menggantikan teks yang ditemukan. Dapat berupa string kosong untuk menghapus teks yang ditemukan. Default: string kosong (menghapus teks yang ditemukan)"new text"
kotak korek apiBooleanPencocokan peka huruf besar/kecil. true = Pencarian peka terhadap huruf besar dan kecil (pencocokan huruf besar dan kecil yang tepat diperlukan), false = Pencarian tidak peka huruf besar/kecil (default). Mengontrol apakah "The" cocok dengan "the" atau hanya "The"false
cocokkan Seluruh KataBooleanPencocokan kata utuh. true = Cocokkan hanya kata-kata lengkap (bukan kecocokan sebagian), false = Mencocokkan sebagian teks dalam kata (default). Mencegah "the" agar tidak cocok dengan "there" atau "other".false

Parameter Opsional​

ParameterJenisKeteranganContoh
nama budayaStringKode budaya untuk pemrosesan dokumen (misalnya, "en-US", "de-DE", "fr-FR")en-US

Pemrosesan Penggantian Teks​

  • Setiap penggantian diproses secara berurutan sesuai dengan urutan yang ditentukan.
  • Beberapa penggantian dapat dilakukan pada dokumen yang sama.
  • Semua kemunculan Find Text akan diganti (kecuali jika menggunakan pencocokan kata utuh).

Keluaran​

Yang PDF4me Ganti Teks 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": "document.docx",
"success": true,
"errorMessage": null
}

Kolom Respons:

  • dokumen (string): Dokumen Word dengan penggantian teks yang diterapkan, dikodekan sebagai Base64 rangkaian
  • nama file (string): Nama file Word keluaran
  • kesuksesan (boolean): Menunjukkan apakah permintaan berhasil
  • pesan kesalahan (string atau null): Detail kesalahan ketika keberhasilan bernilai salah

Cara Penggunaan:

  1. Ekstrak document lapangan dari JSON tanggapan (Base64)
  2. Uraikan kodenya Base64 string untuk mendapatkan data biner dokumen Word
  3. 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

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 (Penggantian Tunggal):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "phrases": [
 {
 "findText": "old text",
 "replaceText": "new text",
 "matchCase": false,
 "matchWholeWord": false
 }
 ],
 "cultureName": "en-US"
}

Contoh Lanjutan (Penggantian Berganda):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "phrases": [
 {
 "findText": "[COMPANY_NAME]",
 "replaceText": "Acme Corporation",
 "matchCase": false,
 "matchWholeWord": false
 },
 {
 "findText": "[DATE]",
 "replaceText": "2024-01-15",
 "matchCase": false,
 "matchWholeWord": false
 },
 {
 "findText": "[CONTACT_EMAIL]",
 "replaceText": "[email protected]",
 "matchCase": false,
 "matchWholeWord": false
 }
 ],
 "cultureName": "en-US"
}

Contoh Kode​

Yang PDF4me Ganti Teks 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 mengganti teks dalam dokumen Word:

Studi Kasus & Aplikasi Industri​

Studi Kasus Layanan Hukum & Profesional

  • Pemrosesan Kontrak: Ganti teks placeholder dengan informasi khusus klien
  • Otomatisasi Dokumen HukumPerbarui nomor kasus, nama klien, dan tanggal.
  • Standardisasi Templat: Menstandarisasi terminologi dan format hukum
  • Komunikasi dengan KlienPersonalisasikan dokumen hukum untuk klien tertentu.

Dapatkan Bantuan​

Get Your API KeyAPI SamplesGetting Started