Lewati ke konten utama
API PDF4meIntegrasiBasis PengetahuanEkstensiPenguji APIBlog

Tambahkan Tanda Air Teks ke Word - Tanda Air Teks API

PDF4me Tambahkan Tanda Air Teks ke Word Memungkinkan Anda menambahkan watermark teks yang dapat disesuaikan ke dokumen Word dengan kontrol penataan dan penempatan yang komprehensif. Ini API Layanan ini memproses file Word dan menambahkan watermark teks dengan kontrol penuh atas konten teks, jenis huruf, ukuran huruf, warna, sudut rotasi, preset orientasi, dan tingkat transparansi. API menerima konten dokumen Word melalui REST API panggilan, memanfaatkan Base64 Pengkodean untuk transmisi yang aman. Dengan dukungan untuk label keamanan, elemen branding, pemberitahuan kerahasiaan, dan penanda status, solusi ini ideal untuk keamanan dokumen, perlindungan merek, dan alur kerja indikasi status.

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​

  • Dukungan Tanda Air TeksTanda air teks profesional dengan konten teks kustom apa pun.
  • Kustomisasi FontKontrol penuh atas jenis huruf, nama huruf, dan ukuran huruf.
  • Pilihan Warna: Warna bernama, kode heksadesimal, nilai RGB, dan dukungan heksadesimal 3 digit
  • Kontrol RotasiSudut rotasi khusus (0-360°) atau pengaturan orientasi yang telah ditentukan sebelumnya
  • Opsi TransparansiEfek tanda air semi-transparan atau sepenuhnya buram.
  • Ukuran OtomatisPenyesuaian ukuran cerdas berdasarkan panjang teks dan ukuran font.
  • Penerapan di Seluruh DokumenTanda air diterapkan pada semua bagian dan judul.
  • Di Balik Penempatan TeksTanda air ditempatkan di belakang konten dokumen.

REST API Titik akhir​

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

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

REST API Parameter​

Daftar lengkap parameter untuk Menambahkan Tanda Air Teks ke Word 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*ObjectDeskripsi dokumen. Harus mencakup Nama (string): nama file Word keluaran dengan ekstensi .docx{ "Name": "document.docx" }
Konten dokumen*Base64Konten dokumen Word yang dikodekan dalam Base64UEsDBBQABgAIAAAA...
Teks tanda air*StringTeks yang akan ditampilkan sebagai watermark. Wajib diisi - tidak boleh kosong, berupa teks kosong, atau hanya spasi. Contoh: "RAHASIA", "DRAFT", "DISETUJUI"CONFIDENTIAL

Parameter Opsional​

ParameterJenisKeteranganContoh
Keluarga fontStringJenis huruf untuk teks tanda air. Umum: "Arial", "Calibri", "Times New Roman", "Helvetica". Default: "Arial"Arial
Ukuran hurufNumber (dobel)Ukuran font dalam poin (1 hingga 1000). Default: 7272
warna hurufStringWarna teks. Nama: "Merah", "Biru", "Abu-abu". Heks: "#FF0000", "FF0000". RGB: "RGB(255,0,0)". Default: "#808080"#FF0000
setengah tembus terangBooleanTransparansi. true = opasitas 50%, false = 100% (default)true
rotasiNumber (dobel)Sudut rotasi kustom (0-360°). Default: 045
nama fontStringNama font untuk teks watermarkArial
orientasiStringOrientasi yang telah ditentukan sebelumnya: Horisontal (0°), Vertikal (90°), Diagonal (45°), Terbalik (180°). Menggantikan rotasi jika disediakanDiagonal
nama budayaStringKode budaya (misalnya, "en-US", "de-DE", "fr-FR"). Bawaan: nolen-US

Opsi Orientasi Teks​

Orientasi teks watermark mengikuti prioritas parameter ini:

  1. orientasi - Jika tersedia, menggunakan sudut orientasi yang telah ditentukan sebelumnya
  2. rotasi - Jika orientasi tidak ditentukan, akan menggunakan sudut rotasi khusus.
  3. Bawaan - Jika tidak ada yang ditentukan, gunakan 0° (horizontal)

Orientasi yang telah ditentukan sebelumnya:​

  • Horisontal: 0° (standar)
  • Vertikal: 90°
  • Diagonal: 45°
  • Terbalik: 180°

Keluaran​

Yang PDF4me Tambahkan Tanda Air Teks ke Word REST API mengembalikan JSON respons (ApiV2WordApiCallRes). Jika berhasil maka API mengembalikan dokumen Word sebagai Base64-string yang dikodekan di dalam document bidang, bukan sebagai data biner.

Respons Sukses

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 tanda air teks yang diterapkan, dikodekan sebagai Base64
  • nama file (string): Nama file Word keluaran
  • kesuksesan (boolean): Apakah operasi berhasil atau tidak
  • pesan kesalahan (string): Pesan kesalahan jika keberhasilan bernilai false; jika tidak, null

Cara Penggunaan:

  1. Memeriksa success; jika benar, ekstrak document lapangan dari JSON tanggapan
  2. Uraikan kodenya Base64 string untuk mendapatkan data biner dokumen Word
  3. Simpan atau proses file Word menggunakan fileName

Contoh (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
if (!data.success) throw new Error(data.errorMessage);
const wordBytes = atob(data.document);
// 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 (Hanya Kolom yang Wajib Diisi):

{
  "document": { "Name": "document.docx" },
  "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
  "watermarkText": "CONFIDENTIAL"
}

Contoh Lanjutan (Dengan Kolom Opsional):

{
  "document": { "Name": "document.docx" },
  "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
  "watermarkText": "CONFIDENTIAL",
  "orientation": "Diagonal",
  "fontFamily": "Arial",
  "fontSize": 72,
  "fontColor": "#FF0000",
  "semiTransparent": true,
  "cultureName": "en-US"
}

Contoh Rotasi Kustom:

{
  "document": { "Name": "document.docx" },
  "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
  "watermarkText": "DRAFT",
  "fontFamily": "Times New Roman",
  "fontSize": 48,
  "fontColor": "Gray",
  "rotation": 45,
  "semiTransparent": true
}

Contoh Kode​

Yang PDF4me Tambahkan Tanda Air Teks ke Word 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 menambahkan watermark teks ke dokumen Word:

Studi Kasus & Aplikasi Industri​

Studi Kasus Layanan Hukum & Profesional

  • Dokumen Rahasia: Memberi tanda air pada dokumen hukum dengan pemberitahuan "RAHASIA"
  • Draf KontrakTandai draf perjanjian dengan status "DRAF - SEDANG DITINJAU"
  • Label Hak Istimewa: Terapkan tanda air teks "HAK ISTIMEWA PENGACARA-KLIEN"
  • Penanda Status: Menunjukkan status "DISETUJUI" atau "MENUNGGU PENINJAUAN"

Dapatkan Bantuan​

Get Your API KeyAPI SamplesGetting Started