Zum Hauptinhalt springen
PDF4me APIIntegrationenWissensdatenbankErweiterungenAPI-TesterBlog

Text durch Bild ersetzen – Bildersetzung API

PDF4me Text durch Bild ersetzen Ermöglicht das Ersetzen von bestimmtem Text durch Bilder in Word-Dokumenten mit erweiterten Seitenfilter- und Größenkontrolloptionen. API Der Dienst verarbeitet Word-Dateien und ersetzt Textplatzhalter durch Bilder mithilfe präziser Textübereinstimmung, anpassbarer Größe unter Beibehaltung des Seitenverhältnisses, seitenbezogener Ausrichtung und flexibler Filteroptionen. API empfängt Word-Dokumentinhalte und Bilddaten über REST API Anrufe, die genutzt werden Base64 Sichere Datenübertragung durch Kodierung. Dank Unterstützung mehrerer Bildformate und vollständiger Kontrolle über das Ersetzungsverhalten eignet sich diese Lösung ideal für Dokumentenautomatisierung, Vorlagenverarbeitung und Workflows zum dynamischen Einfügen von Inhalten.

Verwandte Blog-Beiträge
Zu dieser Funktion gibt es noch keinen Blogbeitrag – folgt in Kürze.
Schauen Sie sich in der Zwischenzeit im PDF4me-Blog Tutorials und Arbeitsabläufe für alle Plattformen an.
Besuchen Sie den Blog →

Authentifizierung Ihres API Anfrage​

Um auf die PDF4me REST APIJede Anfrage muss die entsprechenden Authentifizierungsdaten enthalten. Die Authentifizierung gewährleistet eine sichere Kommunikation und bestätigt Ihre Identität als autorisierter Benutzer des Systems. REST APIDie

Get your api Key

Hauptmerkmale​

  • Text-zu-Bild-Ersetzung: Bestimmte Textzeichenfolgen in Dokumenten durch Bilder ersetzen
  • Präziser Textabgleich: Groß-/Kleinschreibung beachtende Textsuche und -ersetzung
  • Bildgrößensteuerung: Bildabmessungen mit Breiten- und Höhenparametern anpassen
  • Beibehaltung des SeitenverhältnissesBildproportionen beim Skalieren beibehalten
  • Seitenfilterung: Bestimmte Seiten oder Seitenbereiche für den Austausch auswählen
  • Erweiterte Filterung: Erste Seite überspringen, ungerade/gerade Seiten auswählen oder genaue Seitenzahlen angeben
  • Mehrere BildformateUnterstützung für PNG, JPG, JPEG, BMP, GIF Formate
  • Flexible Positionierung: Fügen Sie Bilder als Word-Formen mit präziser Positionierung ein.

REST API Endpunkt​

Der PDF4me REST API verwendet Standard HTTP Methoden zur Interaktion mit Ressourcen. Alle Text-zu-Bild-Ersetzungsvorgänge werden über einen einzigen Endpunkt durchgeführt:

  • Verfahren: POST
  • Endpunkt: office/ApiV2Word/ReplaceTextWithImage

REST API Parameter​

Vollständige Liste der Parameter für die Funktion „Text durch Bild ersetzen“. REST APIDie Parameter sind zur besseren Verständlichkeit und Implementierung nach Kategorien geordnet.

Wichtig: Mit einem Sternchen (*) gekennzeichnete Parameter sind Pflichtfelder. Erweiterte Parameter ermöglichen eine detaillierte Steuerung der Bildgröße und Seitenfilterung.

Erforderliche Parameter​

ParameterTypBeschreibungBeispiel
dokumentieren*ObjectDokumentenbeschreibung. Muss enthalten Name (string): Ausgabedateiname (Word-Datei) mit der Erweiterung .docx{ "Name": "document.docx" }
docContent*Base64Word-Dokumentinhalt kodiert in Base64In diesem Dokument wird Text ersetzt. Es muss sich um ein gültiges Word-Dokument handeln (Formate: .docx, .doc).base64EncodedDocumentContent
findText*StringSuchtext im Dokument. Groß-/Kleinschreibung beachten. Alle Vorkommen werden durch das Bild ersetzt. Darf nicht leer sein. Beispiele: "[LOGO]", "SIGN_HERE""text to replace"
Bildinhalt*Base64Inhalt der Ersatzbilddatei kodiert in Base64. Muss ein gültiges Bild sein (PNG, JPG, JPEG, BMP, GIF)base64EncodedImageContent

Optionale Parameter​

ParameterTypBeschreibungBeispiel
BreiteZahl (doppelt)Bildbreite200
HöheZahl (doppelt)Bildhöhe100
Seitenverhältnis beibehaltenBooleanBildproportionen beim Skalieren beibehalten. Standard: Jatrue
überspringenErsteSeiteBooleanErsetzung auf der ersten Seite überspringen. true = erste Seite überspringen, false = einschließen (Standardeinstellung). Nützlich für Deckblätter/Titelseitenfalse
applyToStringZielfernrohr für Ersatz-
SeitenzahlenStringBestimmte Seitenzahlen oder Seitenbereiche (z. B. „1,2,3“ oder „1,3,5–7“). Leer = alle Seiten"1,2,3"
Seitenzahlen ignorierenStringSeitenzahlen, die von der Ersetzung ausgeschlossen werden sollen-
KulturnameStringKulturcode (z. B. „en-US“, „fr-FR“, „de-DE“). Standard: nullen-US

Seitenfilterung​

Der API Unterstützt die Seitenfilterung über die folgenden Parameter:

  • überspringenErsteSeiteSteuert, ob die erste Seite übersprungen werden soll.
  • Seitenzahlen: Gibt an, welche Seiten verarbeitet werden sollen (leere Zeichenkette = alle Seiten)
  • Seitenzahlen ignorieren: Auszuschließende Seitenzahlen

Unterstützte Bildformate​

Text durch Bild ersetzen API Unterstützt verschiedene Bildformate für maximale Kompatibilität:

FormatVerlängerungBeschreibung
PNG.pngPortable Network Graphics (PNG) – ideal für Logos und Grafiken mit Transparenz
JPEG.jpg, .jpegGemeinsame Expertengruppe für Fotografie – am besten geeignet für Fotografien und komplexe Bilder
BMP.bmpBitmap – unkomprimiertes Format, größere Dateigrößen
GIF.gifGrafikaustauschformat – unterstützt Animation und Transparenz

Ausgabe​

Der PDF4me Text durch Bild ersetzen REST API gibt ein zurück JSON Antwort (ApiV2WordApiCallResBei Erfolg API gibt das Word-Dokument als Base64-kodierte Zeichenkette im document Feld, nicht als Binärdaten.

Erfolgsantwort

Statuscode: 200 OK

Inhaltstyp: application/json

Antworttext:

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

Antwortfelder:

  • dokumentieren (string): Das Word-Dokument, in dem der Text durch Bilder ersetzt wurde, kodiert als Base64
  • Dateiname (string): Der Name der ausgegebenen Word-Datei
  • Erfolg (boolean): Ob die Operation erfolgreich war
  • Fehlermeldung (stringFehlermeldung, falls der Erfolg nicht eintritt; andernfalls null.

Anwendungshinweise:

  1. Überprüfen successFalls zutreffend, extrahieren Sie die document Feld vom JSON Antwort
  2. Entschlüsseln Sie die Base64 Zeichenkette zum Abrufen der binären Word-Dokumentdaten
  3. Speichern oder bearbeiten Sie die Word-Datei mit fileName

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

Beispielanfrage​

Kopfzeile​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Notiz:

  • Hol dir deins API Schlüssel vom PDF4me Armaturenbrett
  • Der API Der Schlüssel muss sein Base64 kodiert und mit "Basic" präfixiert in der Authorization Überschrift
  • Beispiel: Wenn Ihr API Schlüssel ist abc123, kodieren Sie es zu Base64 und verwenden Authorization: Basic YWJjMTIz

Nutzlast​

Einfaches Beispiel (nur Pflichtfelder):

{
 "document": { "Name": "document.docx" },
 "docContent": "base64EncodedDocumentContent",
 "findText": "text to replace",
 "imageContent": "base64EncodedImageContent",
 "cultureName": "en-US"
}

Erweitertes Beispiel (mit optionalen Feldern):

{
 "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"
}

Codebeispiele​

Der PDF4me Text durch Bild ersetzen REST API Es werden Codebeispiele in verschiedenen Programmiersprachen bereitgestellt. Wählen Sie die Sprache, die am besten zu Ihrer Entwicklungsumgebung passt:

C# (CSharp) Probe

Vollständig C# Implementierung zum Ersetzen von Text durch Bilder in Word-Dokumenten:

Branchenspezifische Anwendungsfälle und Anwendungen​

Anwendungsfälle für Rechts- und Beratungsdienstleistungen

  • Vertragsabwicklung: Platzhalter für Unterschriften durch autorisierte Unterschriften ersetzen
  • Automatisierung juristischer Dokumente: Firmenlogos und Wasserzeichen in Rechtsdokumente einfügen
  • Personalisierung von Kundendokumenten: Fügen Sie kundenspezifische Bilder zu Rechtsdokumenten hinzu
  • Konformitätsdokumentation: Konformitätsstempel und Siegel in Dokumente einfügen

Hilfe erhalten​

Get Your API KeyAPI SamplesGetting Started