Passa al contenuto principale
PDF4me APIIntegrazioniBase di conoscenzaEstensioniTester APIBlog

Sostituisci il testo con un'immagine - Sostituzione immagine API

PDF4me Sostituisci il testo con un'immagine consente di sostituire il testo specificato con immagini nei documenti Word con opzioni avanzate di filtro pagina e controllo delle dimensioni. API Il servizio elabora i file Word e sostituisce i segnaposto di testo con immagini utilizzando una corrispondenza di testo precisa, un dimensionamento personalizzabile con conservazione delle proporzioni, un targeting specifico per pagina e opzioni di filtraggio flessibili. API riceve il contenuto del documento Word e i dati delle immagini tramite REST API chiamate, utilizzando Base64 Codifica per una trasmissione sicura. Grazie al supporto di molteplici formati di immagine e al controllo completo sul comportamento di sostituzione, questa soluzione è ideale per l'automazione dei documenti, l'elaborazione di modelli e i flussi di lavoro di inserimento dinamico dei contenuti.

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​

  • Sostituzione del testo con l'immagine: Sostituire specifiche stringhe di testo con immagini in tutto il documento
  • Corrispondenza precisa del testoRicerca e sostituzione del testo con distinzione tra maiuscole e minuscole
  • Controllo delle dimensioni dell'immagine: Personalizza le dimensioni dell'immagine con i parametri di larghezza e altezza
  • Conservazione del rapporto d'aspetto: Mantieni le proporzioni dell'immagine durante il ridimensionamento
  • Filtro pagina: Selezionare pagine o intervalli di pagine specifici da sostituire
  • Filtro avanzato: Salta la prima pagina, seleziona le pagine pari/dispari oppure specifica i numeri di pagina esatti
  • Diversi formati di immagine: Supporto per PNG, JPG, JPEG, BMP, GIF formati
  • Posizionamento flessibile: Inserisci le immagini come forme di Word con posizionamento preciso

REST API Punto finale​

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

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

REST API Parametri​

Elenco completo dei parametri per la funzione Sostituisci testo con immagine REST APII parametri sono organizzati per categoria per una migliore comprensione e implementazione.

Importante: I parametri contrassegnati da un asterisco (*) sono obbligatori. I parametri avanzati consentono un controllo preciso sulle dimensioni delle immagini e sul filtraggio delle pagine.

Parametri richiesti​

ParametroTipoDescrizioneEsempio
documento*ObjectDescrizione del documento. Deve includere Nome string): output Nome del file Word con estensione .docx{ "Name": "document.docx" }
docContent*Base64Il contenuto del documento Word codificato in Base64La sostituzione del testo viene eseguita su questo documento. Deve essere un documento Word valido (formati .docx, .doc).base64EncodedDocumentContent
trovaTesto*StringStringa di testo da cercare nel documento. Distinguibile dalle maiuscole/minuscole. Tutte le occorrenze verranno sostituite con l'immagine. Non può essere nulla o vuota. Esempi: "[LOGO]", "SIGN_HERE""text to replace"
Contenuto dell'immagine*Base64Contenuto del file immagine di sostituzione codificato in Base64. Deve essere un'immagine valida (PNG, JPG, JPEG, BMP, GIF)base64EncodedImageContent

Parametri opzionali​

ParametroTipoDescrizioneEsempio
larghezzaNumero (doppio)larghezza dell'immagine200
altezzaNumero (doppio)altezza dell'immagine100
mantieni il rapporto d'aspettoBooleanMantieni le proporzioni dell'immagine durante il ridimensionamento. Predefinito: truetrue
saltaPrimaPaginaBooleanSalta la sostituzione nella prima pagina. true = salta la prima pagina, false = includi (predefinito). Utile per pagine di copertina/titolofalse
applicaToStringAmbito di intervento previsto per la sostituzione-
numeri di paginaStringNumeri di pagina o intervalli specifici (ad esempio, "1,2,3" o "1,3,5-7"). Vuoto = tutte le pagine"1,2,3"
ignora i numeri di paginaStringNumeri di pagina da escludere dalla sostituzione-
Nome della culturaStringCodice culturale (ad esempio, "en-US", "fr-FR", "de-DE"). Predefinito: nulloen-US

Filtro pagina​

IL API Supporta il filtraggio delle pagine tramite i seguenti parametri:

  • saltaPrimaPagina: Controlla se saltare la prima pagina
  • numeri di paginaSpecifica quali pagine elaborare (stringa vuota = tutte le pagine)
  • ignora i numeri di pagina: Numeri di pagina da escludere

Formati immagine supportati​

Sostituisci il testo con un'immagine API supporta vari formati di immagine per la massima compatibilità:

FormatoEstensioneDescrizione
PNG.pngGrafica di rete portatile (PNG): ideale per loghi e grafica con trasparenza.
JPEG.jpg, .jpegJoint Photographic Experts Group - ideale per fotografie e immagini complesse
BMP.bmpBitmap - formato non compresso, dimensioni dei file maggiori
GIF.gifFormato di interscambio grafico (GIST) - supporta animazioni e trasparenza

Produzione​

IL PDF4me Sostituisci il testo con un'immagine REST API restituisce un JSON risposta (ApiV2WordApiCallRes). In caso di successo il 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 string): Il documento Word con il testo sostituito da immagini, codificato come Base64
  • Nome file string): Il nome del file Word di output
  • successo boolean): Se l'operazione è riuscita
  • messaggio di errore string): 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": "base64EncodedDocumentContent",
 "findText": "text to replace",
 "imageContent": "base64EncodedImageContent",
 "cultureName": "en-US"
}

Esempio avanzato (con campi opzionali):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "findText": "text to replace",
 "imageContent": "base64EncodedImageContent",
 "width": 200,
 "height": 100,
 "maintainAspectRatio": true,
 "skipFirstPage": true,
 "pageNumbers": "1,2,3",
 "ignorePageNumbers": null,
 "cultureName": "en-US"
}

Esempi di codice​

IL PDF4me Sostituisci il testo con un'immagine REST API Fornisce esempi di codice in diversi linguaggi di programmazione. Scegli il linguaggio più adatto al tuo ambiente di sviluppo:

C# CSharp) Campione

Completo C# Implementazione per la sostituzione del testo con immagini nei documenti Word:

Casi d'uso e applicazioni industriali​

Casi d'uso per servizi legali e professionali

  • Elaborazione contrattuale: Sostituire i segnaposto della firma con le firme autorizzate
  • Automazione dei documenti legaliInserire loghi e filigrane aziendali nei documenti legali
  • Personalizzazione del documento del clienteAggiungere immagini specifiche del cliente ai documenti legali
  • Documentazione di conformitàInserire timbri e sigilli di conformità nei documenti

Richiedi assistenza​

Get Your API KeyAPI SamplesGetting Started