Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Aggiungi filigrana di testo a Word - Filigrana di testo API

PDF4me Aggiungi filigrana di testo a Word consente di aggiungere filigrane di testo personalizzabili ai documenti Word con un controllo completo sullo stile e sul posizionamento. API Il servizio elabora i file Word e aggiunge filigrane di testo con il pieno controllo su contenuto del testo, famiglia di caratteri, dimensione del carattere, colori, angoli di rotazione, preimpostazioni di orientamento e livelli di trasparenza. API riceve il contenuto del documento Word tramite REST API chiamate, utilizzando Base64 Codifica per una trasmissione sicura. Grazie al supporto per etichette di sicurezza, elementi di branding, avvisi di riservatezza e indicatori di stato, questa soluzione è ideale per la sicurezza dei documenti, la protezione del marchio e i flussi di lavoro di indicazione dello stato.

Articoli correlati del blog
Non ci sono ancora post sul blog dedicati a questa funzionalità — in arrivo a breve.
Nel frattempo, dai un'occhiata al blog di PDF4me per trovare tutorial e procedure operative su tutte le piattaforme.
Visita il blog →

Autenticazione del tuo API Richiesta​

Per accedere al PDF4me REST API, ogni richiesta deve includere credenziali di autenticazione adeguate. L'autenticazione garantisce una comunicazione sicura e convalida la tua identità come utente autorizzato del REST API.

Get your api Key

Caratteristiche principali​

  • Supporto per filigrana di testoFiligrane di testo professionali con qualsiasi contenuto testuale personalizzato
  • Personalizzazione dei caratteriControllo completo su famiglia di caratteri, nome del carattere e dimensione del carattere.
  • Opzioni di colore: Supporto per colori denominati, codici esadecimali, valori RGB e numeri esadecimali a 3 cifre
  • Controllo della rotazioneAngoli di rotazione personalizzati (0-360°) o impostazioni di orientamento predefinite
  • Opzioni di trasparenzaEffetti di filigrana semitrasparenti o completamente opachi
  • Dimensionamento automatico: Dimensionamento intelligente in base alla lunghezza del testo e alla dimensione del carattere
  • Applicazione a livello di documentoFiligrane applicate a tutte le sezioni e alle intestazioni
  • Posizionamento del testo dietroFiligrane posizionate dietro il contenuto del documento

REST API Punto finale​

IL PDF4me REST API utilizza standard HTTP Metodi per interagire con le risorse. Tutte le operazioni di aggiunta di filigrane di testo vengono eseguite tramite un unico endpoint:

  • Metodo: POST
  • Punto finale: office/ApiV2Word/AddTextWatermark

REST API Parametri​

Elenco completo dei parametri per Aggiungi filigrana di testo a Word REST APII parametri sono organizzati per categoria per una migliore comprensione e implementazione.

Importante: I parametri contrassegnati da un asterisco (*) sono obbligatori e devono essere forniti per il API per funzionare correttamente.

Parametri richiesti​

ParametroTipoDescrizioneEsempio
documento*ObjectDescrizione del documento. Deve includere Nome (stringa): visualizza il nome del file Word con estensione .docx{ "Name": "document.docx" }
docContent*Base64Il contenuto del documento Word codificato in Base64UEsDBBQABgAIAAAA...
filigranaTesto*StringTesto da visualizzare come filigrana. Obbligatorio - non può essere nullo, vuoto o composto solo da spazi. Esempi: "RISERVATO", "BOZZA", "APPROVATO"CONFIDENTIAL

Parametri opzionali​

ParametroTipoDescrizioneEsempio
fontFamilyStringFamiglia di caratteri per il testo della filigrana. Comuni: "Arial", "Calibri", "Times New Roman", "Helvetica". Predefinito: "Arial"Arial
dimensione del carattereNumber (doppio)Dimensione del carattere in punti (da 1 a 1000). Valore predefinito: 7272
fontColorStringColore del testo. Nome: "Rosso", "Blu", "Grigio". Esadecimale: "#FF0000", "FF0000". RGB: "RGB(255,0,0)". Predefinito: "#808080"#FF0000
semitrasparenteBooleanTrasparenza. true = opacità 50%, false = 100% (predefinito)true
rotazioneNumber (doppio)Angolo di rotazione personalizzato (0-360°). Predefinito: 045
nome del carattereStringNome del carattere per il testo della filigranaArial
orientamentoStringOrientamento predefinito: Orizzontale (0°), Verticale (90°), Diagonale (45°), Capovolto (180°). Sovrascrive la rotazione se fornitaDiagonal
Nome della culturaStringCodice culturale (ad esempio, "en-US", "de-DE", "fr-FR"). Predefinito: nulloen-US

Opzioni di orientamento del testo​

L'orientamento del testo della filigrana segue questa priorità dei parametri:

  1. orientamento - Se fornito, utilizza l'angolo di orientamento predefinito
  2. rotazione - Se l'orientamento non è specificato, viene utilizzato un angolo di rotazione personalizzato.
  3. Predefinito - Se non viene fornito alcun valore, si utilizza 0° (orizzontale)

Orientamenti predefiniti:​

  • Orizzontale: 0° (predefinito)
  • Verticale: 90°
  • Diagonale: 45°
  • Capovolto: 180°

Produzione​

IL PDF4me Aggiungi filigrana di testo a Word REST API restituisce un JSON risposta (ApiV2WordApiCallRes). In caso di successo la API restituisce il documento Word come un Base64stringa codificata nel document campo, non come dati binari.

Risposta di successo

Codice di stato: 200 OK

Tipo di contenuto: application/json

Corpo della risposta:

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

Campi di risposta:

  • documento (stringa): Il documento Word con la filigrana di testo applicata, codificato come Base64
  • Nome file (stringa): Il nome del file Word di output
  • successo (booleano): Indica se l'operazione è andata a buon fine.
  • messaggio di errore (stringa): Messaggio di errore se il successo è falso; altrimenti nullo

Come si usa:

  1. Controllo success; se vero, estrai il document campo dal JSON risposta
  2. decodificare il Base64 stringa per ottenere i dati binari del documento Word
  3. Salva o elabora il file Word utilizzando fileName

Esempio (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

Esempio di richiesta​

Intestazione​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Nota:

  • Ottieni il tuo API chiave dalla PDF4me Pannello di controllo
  • IL API la chiave deve essere Base64 codificato e prefissato con "Basic" nel Authorization intestazione
  • Esempio: se il tuo API la chiave è abc123, codificalo in Base64 e utilizzare Authorization: Basic YWJjMTIz

Carico utile​

Esempio di base (solo campi obbligatori):

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

Esempio avanzato (con campi opzionali):

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

Esempio di rotazione personalizzata:

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

Esempi di codice​

IL PDF4me Aggiungi filigrana di testo a Word REST API Fornisce esempi di codice in diversi linguaggi di programmazione. Scegli il linguaggio più adatto al tuo ambiente di sviluppo:

C# Esempio (CSharp)

Completo C# Implementazione per aggiungere filigrane di testo ai documenti Word:

Casi d'uso e applicazioni industriali​

Casi d'uso per servizi legali e professionali

  • Documenti riservati: Aggiungere filigrane con la dicitura "RISERVATO" ai documenti legali
  • Bozze di contrattiContrassegnare le bozze degli accordi con lo stato "BOZZA - IN FASE DI REVISIONE"
  • Etichette Privilegio: Applicare filigrane di testo con la dicitura "SEGRETO AVVOCATO-CLIENTE"
  • Indicatori di statoIndicare lo stato "APPROVATO" o "IN ATTESA DI REVISIONE"

Richiedi assistenza​

Get Your API KeyAPI SamplesGetting Started