Tambahkan Tanda Air ke Word

PDF4me Tambahkan Tanda Air ke Word adalah sebuah REST titik akhir yang membubuhkan tanda air berupa gambar di belakang teks setiap halaman dalam sebuah Word dokumen. POST file .docx dan gambar watermark sebagai Base64 ke office/ApiV2Word/AddWatermark, sesuaikan skala, transparansi, dan perataan, lalu dekode file yang diberi watermark dari JSON tanggapan. PNG, JPG, JPEGGambar , BMP, dan GIF didukung.

Fungsi dari endpoint ini

Mengambil Word Dokumen ini menerima gambar dan mengembalikan dokumen yang sama dengan gambar tersebut yang dicap di belakang teks setiap bagian: logo, spanduk RAHASIA, cap DRAFT. Anda dapat mengontrol ukurannya (poin tepat atau faktor skala), pengaktifan/penonaktifan transparansi 50 persen, dan penempatan di tengah atau kiri atas. Responsnya adalah... JSON dengan hasil sebagai berikut: Base64 isi.

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

Setiap PDF4me REST panggilan harus menyertakan Anda API kunci di Authorization Header sebagai otentikasi Dasar. Dapatkan atau putar kunci Anda dari dasbor pengembang.

Get your API Key

Titik akhir

POSTkantor/ApiV2Word/TambahkanTandaAir

Tukang Pos URLhttps://api.pdf4me.com/office/ApiV2Word/AddWatermark

Fakta Penting yang Tidak Boleh Anda Lewatkan

Jawabannya adalah Base64 JSON, bukan file

Dokumen bertanda air tersebut akan kembali sebagai Base64 tali di dalam JSON tubuh dengan fileName, success, Dan pesan kesalahan. Dekode terlebih dahulu sebelum menyimpan; respons mentah bukanlah file .docx yang valid.

Lebar dan tinggi mengesampingkan skala.

Prioritas ukuran adalah ketepatan. lebar/tinggi dalam poin-poin terlebih dahulu, lalu skala, lalu ukuran gambar aslinya. Kirim hanya satu dimensi dan dimensi lainnya akan dihitung untuk mempertahankan rasio aspek.

Di balik teks, di setiap bagian

Gambar tersebut dicetak di belakang isi dokumen di semua bagian dan judul, sehingga teks tetap mudah dibaca. Gambar transparan ini PNG ditambah semitransparan: benar memberikan tampilan stempel halus klasik.

HTTP pengaturan

Metode: POST
URL: https://api.pdf4me.com/office/ApiV2Word/AddWatermark
Tipe Konten: aplikasi/json
Authorization: Dasar <Anda PDF4me API kunci>

Jawabannya adalah... JSON: periksa success bendera, lalu Base64-mendekode konten dokumen yang dikembalikan dan menyimpannya dengan .docx Ekstensi.

Bagaimana cara kerja prioritas ukuran watermark?

Terdapat tiga input ukuran yang diurutkan secara ketat. API menggunakan input dengan prioritas tertinggi yang sebenarnya Anda kirim dan mengabaikan sisanya.

Ukuran input vs perilaku	Saat itu berlaku	Apa yang didapatkan oleh tanda air
`width` Dan `height` (poin)	Prioritas tertinggi; mengesampingkan `scale` ketika hadir	Persis sesuai dimensi yang Anda tentukan. Satu dimensi saja sudah cukup untuk mempertahankan rasio aspek.
`scale` (0,1 hingga 10,0)	Hanya digunakan jika tidak ada informasi lebar atau tinggi yang dikirimkan.	Ukuran gambar asli dikalikan dengan faktor: 0,5 adalah setengah ukuran, 2,0 adalah dua kali lipat.
Tidak ada yang mengirim	Cadangan	Dimensi piksel asli dari gambar yang diunggah

API bidang tubuh

Parameter	Diperlukan	Jenis	Apa fungsinya?	Contoh
`document`	Required	object	Document reference carrying Name, the Word filename with its .docx extension.	`{ "Name": "document.docx" }`
`docContent`	Required	string	Base64-encoded bytes of the Word document to watermark.	`UEsDBBQABgAIAAAA...`
`watermarkFileName`	Required	string	Watermark image filename with its extension. PNG, JPG, JPEG, BMP, and GIF are supported.	`watermark.png`
`watermarkFileContent`	Required	string	Base64-encoded bytes of the watermark image. A PNG with a transparent background gives the cleanest behind-text result.	`iVBORw0KGgo...`
`scale`	Optional	number	Scale factor from 0.1 to 10.0 applied to the original image size. Default 1.0. Ignored when width or height is sent.	`1.5`
`semiTransparent`	Optional	boolean	true renders the watermark at 50 percent opacity for a subtle stamp; false (default) keeps full opacity.	`true`
`width`	Optional	number	Exact watermark width in points. Overrides scale. If height is omitted it is calculated to keep the aspect ratio.	`200`
`height`	Optional	number	Exact watermark height in points. Overrides scale. If width is omitted it is calculated to keep the aspect ratio.	`150`
`alignImage`	Optional	boolean	true (default) centers the watermark on the page; false aligns it top-left within the margins.	`true`
`cultureName`	Optional	string	Culture code applied to document metadata during processing, for example en-US or de-DE.	`en-US`

Contoh muatan

Permintaan minimal (hanya kolom yang wajib diisi)

{
 "document": { "Name": "document.docx" },
 "docContent": "UEsDBBQABgAIAAAA...",
 "watermarkFileName": "watermark.png",
 "watermarkFileContent": "iVBORw0KGgoAAAANSUhEUgAA..."
}

Berukuran, semi-transparan, terpusat

{
 "document": { "Name": "contract-draft.docx" },
 "docContent": "UEsDBBQABgAIAAAA...",
 "watermarkFileName": "confidential.png",
 "watermarkFileContent": "iVBORw0KGgoAAAANSUhEUgAA...",
 "width": 200,
 "height": 150,
 "semiTransparent": true,
 "alignImage": true,
 "cultureName": "en-US"
}

Tips pengambilan oleh tukang pos

Headers

Content-Type: application/json + Authorization: Basic <apiKey>.

Body

raw JSON with TWO Base64 fields: docContent for the Word file and watermarkFileContent for the image. Both must be encoded separately.

Sizing

Send width/height OR scale, not both. If you send both, the exact dimensions win and scale is silently ignored.

Response

JSON with a success flag and Base64 document content. Decode the document field before saving as .docx.

contoh curl

curl -X POST https://api.pdf4me.com/office/ApiV2Word/AddWatermark \
 -H "Content-Type: application/json" \
 -H "Authorization: Basic YOUR_API_KEY" \
 -d '{
 "document": { "Name": "document.docx" },
 "docContent": "'"$(base64 -w 0 document.docx)"'",
 "watermarkFileName": "watermark.png",
 "watermarkFileContent": "'"$(base64 -w 0 watermark.png)"'",
 "semiTransparent": true
 }' \
 --output response.json

Apa arti dari API kembali?

A JSON hasil yang membawa dokumen bertanda air sebagai Base64.

Bidang	Jenis	Isi di dalamnya
`document`	String (Base64)	The watermarked Word document content. Decode to bytes and save with a .docx extension.
`fileName`	String	Output filename for the watermarked document.
`success`	Boolean	true when watermarking succeeded. Check this before decoding content.
`errorMessage`	String	Populated when success is false: invalid Base64, a corrupted document or image, or out-of-range sizing values.

Perilaku asinkron (202 Accepted dengan jajak pendapat URL di dalam Location Header tersebut dikendalikan oleh konfigurasi server, bukan oleh parameter body permintaan. Ketika kode status 202 tiba, lakukan polling pada server. Location URL dengan GET permintaan hingga Anda menerima 200 OK dengan yang sama JSON membentuk.

Contoh kode

Word Endpoint kantor belum tercakup oleh folder sampel per-endpoint di repositori sampel; ini membawa pola permintaan yang digunakan oleh setiap PDF4me keluarga titik akhir:

View API Samples Repository

Pertanyaan yang Sering Diajukan (FAQ)

Which image formats can I use as a Word watermark?+

PNG, JPG, JPEG, BMP, and GIF. A PNG with a transparent background gives the cleanest result because the image is stamped behind the document text on every page.

Is the response the Word file itself?+

No. The API returns JSON containing the watermarked document as a Base64 string plus fileName, success, and errorMessage fields. Decode the document field to bytes before saving as .docx.

What happens if I send both scale and width or height?+

Width and height win. Exact dimensions in points always override the scale factor. If you provide only one of the two, the other is calculated automatically to preserve the image aspect ratio.

Does the watermark cover the document text?+

No. The watermark is placed behind the text, in every section of the document, so the content stays readable. Set semiTransparent to true for a subtle 50 percent opacity effect.

Can this endpoint add text watermarks like DRAFT or CONFIDENTIAL?+

This endpoint stamps images. For text stamps use the Add Text Watermark to Word endpoint, or render your text as a transparent PNG and pass it here as the watermark image.

Where does the watermark appear in the document?+

Across all sections and their headers, behind the content. alignImage true centers it on the page; false places it top-left within the margins. Per-page or per-range placement is not part of this action.

Does adding a watermark protect the document from editing?+

No. A watermark is a visual marker, not a security control; anyone who can edit the file can remove it. To restrict editing or require a password, chain the Secure Word Document endpoint after this one.

Mengapa menambahkan tanda air melalui API alih-alih secara manual Word?

Rute manualnya adalah menyisipkan tanda air gambar di Word: Buka setiap file, tab Desain, Tanda Air, Tanda Air Kustom, pilih gambar, simpan, ulangi. Cara ini tidak efektif untuk alur kerja kontrak yang memberi stempel pada setiap draf yang keluar. API menerapkan stempel di belakang teks yang sama seperti satu permintaan deterministik per berkas, dengan ukuran poin yang tepat seperti Word dialog tidak mengungkapkan. Hasilnya standar penandaan air digital untuk penandaan asal usul dan status, diterapkan dengan kecepatan alur kerja.