Seiten aus Word löschen – Seitenverwaltung API
PDF4me Seiten aus Word löschen Ermöglicht das Entfernen bestimmter Seiten oder Seitenbereiche aus Word-Dokumenten mit flexiblen Seitenauswahloptionen. API Der Dienst verarbeitet Word-Dateien und löscht Seiten mithilfe von bereichsbasierter Löschung (von der ersten bis zur letzten Seite), Löschung bestimmter Seitenzahlen (kommagetrennte Listen) und kombinierten Löschmustern. API empfängt Word-Dokumentinhalte über REST API Anrufe, die genutzt werden Base64 Verschlüsselung für sichere Übertragung. Dank der vollständigen Kontrolle über Seitenauswahl, Dokumentoptimierung und Inhaltsbereinigung eignet sich diese Lösung ideal für Workflows zur Dokumentenverfeinerung, Inhaltsverwaltung und Dokumentenerstellung.
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
Hauptmerkmale
- Flexible SeitenauswahlSeiten nach Bereich, bestimmter Nummer oder einer Kombination aus beidem löschen
- Bereichsbasierte LöschungEntfernen Sie aufeinanderfolgende Seiten von der ersten bis zur letzten Seite.
- Löschung bestimmter SeitenEinzelne Seiten mithilfe von durch Kommas getrennten Seitenzahlen entfernen.
- DokumentenoptimierungDokumente bereinigen, indem unerwünschte Inhalte entfernt werden
- Formaterhaltung: Beibehaltung der ursprünglichen Dokumentformatierung und -struktur
- Metadatenerhaltung: Dokumenteigenschaften und benutzerdefinierte Metadaten beibehalten
- ValidierungAutomatische Seitenzahlvalidierung und Fehlerbehandlung
- Kulturförderung: Lokalisierungsspezifische Dokumentenverarbeitung
REST API Endpunkt
Der PDF4me REST API verwendet Standard HTTP Methoden zur Interaktion mit Ressourcen. Alle Seitenlöschvorgänge werden über einen einzigen Endpunkt durchgeführt:
- Verfahren: POST
- Endpunkt:
office/ApiV2Word/DeletePages
REST API Parameter
Vollständige Liste der Parameter für die Funktion „Seiten aus Word löschen“ REST APIDie Parameter sind zur besseren Verständlichkeit und Implementierung nach Kategorien geordnet.
Wichtig: Mit einem Sternchen (*) gekennzeichnete Parameter sind erforderlich. Mindestens ein Parameter zum Löschen von Seiten (Startseite, Endseite oder Seitenzahlen) muss angegeben werden.
Erforderliche Parameter
| Parameter | Typ | Beschreibung | Beispiel |
|---|---|---|---|
| dokumentieren* | Object | Dokumentenreferenz. Muss enthalten Name (Zeichenkette): Name der Word-Datei mit der Dateiendung .docx | { "Name": "document.docx" } |
| docContent* | Base64 | Word-Dokumentinhalt kodiert in Base64 | UEsDBBQABgAIAAAA... |
Optionale Parameter (Mindestens einer ist für das Löschen einer Seite erforderlich)
| Parameter | Typ | Beschreibung | Beispiel |
|---|---|---|---|
| Startseite | Integer | Startseitennummer (1-basiertes Inhaltsverzeichnis). Seitenzahl, ab der gelöscht werden soll. Muss mindestens 1 und maximal der Seitenzahl des Dokuments entsprechen. Wird nur die Startseitennummer angegeben, werden die Daten von dieser Seite bis zum Ende des Dokuments gelöscht. Darf nicht größer als die Seitenzahl des Dokuments sein. | 2 |
| endPage | Integer | Endseitennummer (1-basiertes Inhaltsverzeichnis). Seitenzahl, bei der der Löschvorgang beendet werden soll. Muss mindestens der Startseitennummer und maximal der Seitenzahl des Dokuments entsprechen. Der Bereich umfasst alle Seiten (Start- und Endseite werden gelöscht). Kann mit Seitenzahlen für komplexe Löschmuster kombiniert werden. | 5 |
| Seitenzahlen | String | Kommagetrennte Liste der zu löschenden Seitenzahlen. Format: "1,3,4" oder "1-3,5,7-9". Kann allein oder in Kombination mit startPage/endPage verwendet werden. Ungültige Seitenzahlen werden ignoriert. Beispiel: "2,4,6,8" löscht die Seiten 2, 4, 6 und 8. | "2,4,6" |
| Kulturname | String | Kulturcode für die Dokumentenverarbeitung (z. B. „en-US“, „de-DE“, „fr-FR“). Standardwert: null (keine kulturspezifische Verarbeitung). Beeinflusst die Dokumentsprache und -formatierung. | en-US |
Seitenlöschmodi
Der API unterstützt mehrere Seitenlöschmodi:
- Bereichslöschung: Verwenden
startPageUndendPageaufeinanderfolgende Seiten löschen - Löschung bestimmter Seiten: Verwenden
pageNumberseinzelne Seiten löschen - Kombinierte Löschung: Verwenden Sie sowohl Bereichs- als auch spezifische Seitenparameter zusammen
- Löschen, um zu beenden: Nur verwenden
startPageVon dieser Seite bis zum Dokumentenende löschen
Notiz: Alle Seitenzahlen beginnen bei 1 (erste Seite = 1, nicht 0). Die Seitenzahlen werden automatisch mit der Seitenzahl des Dokuments abgeglichen.
Ausgabe
Der PDF4me Seiten aus Word löschen REST API Die Antwort hängt vom Verarbeitungsmodus ab. API gibt das Word-Dokument als Base64-kodierte Zeichenkette in JSON Format, nicht als Binärdaten.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Synchrone Verarbeitung (Standard)
Der API verarbeitet die Anfrage und gibt Folgendes zurück:
Statuscode: 200 OK
Inhaltstyp: application/json
Antworttext:
{
"document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"fileName": "document.docx",
"success": true,
"errorMessage": null
}
Antwortfelder:
- dokumentieren (Zeichenkette): Das Word-Dokument, bei dem die angegebenen Seiten gelöscht wurden, kodiert als Base64 Zeichenkette
- Dateiname (Zeichenkette): Der Name der Word-Ausgabedatei
- Erfolg (Boolescher Wert): Gibt an, ob die Anfrage erfolgreich war.
- Fehlermeldung (Zeichenkette oder null): Fehlerdetails, wenn Erfolg nicht gegeben ist
Anwendungshinweise:
- Extrahieren Sie die
documentFeld vom JSON Antwort (Base64) - Entschlüsseln Sie die Base64 Zeichenkette zum Abrufen der binären Word-Dokumentdaten
- Speichern oder bearbeiten Sie die Word-Datei nach Bedarf.
Beispiel (JavaScript):
const response = await fetch(url, options);
const data = await response.json();
const wordBytes = atob(data.document); // Decode Base64
// Save or process wordBytes
Asynchrone Verarbeitung
Asynchrones Verhalten (202 Accepted (mit Polling) wird durch die Serverkonfiguration gesteuert, nicht durch einen Parameter im Anfragetext. Wenn aktiviert, API kann bei einer Abfrage den Statuscode 202 zurückgeben. URL im Location Überschrift. Fragen Sie die URL mit GET Stellen Sie so lange Anfragen, bis Sie 200 erhalten. OK mit der gleichen Antwortstruktur (Dokument, Dateiname, Erfolgsmeldung, Fehlermeldung).
Fehlermeldungen
Der API Standard-Rückgabe HTTP Fehlercodes mit Fehlerdetails:
- Ungültige Anfrageparameter
- Fehlende Pflichtfelder (
dokumentierenmitName,docContent) - Mindestens ein Kriterium für die Seitenlöschung ist erforderlich (
Startseite,endPage, oderSeitenzahlen) - Ungültig Base64 Kodierung in
docContent - Ungültiges oder beschädigtes Word-Dokument
Startseitedarf nicht größer sein alsendPage- Ungültige Seitenzahlen (außerhalb des Dokumentbereichs)
- Ungültig oder fehlend API Schlüssel
- API Schlüssel nicht richtig Base64 kodiert in Authorization Überschrift
- Fehlen
Autorisierung: BasisÜberschrift
- Serverseitiger Verarbeitungsfehler
- Fehler bei der Verarbeitung des Word-Dokuments
- Fehler beim Löschen der Seite
Fehlerantwortformat:
{
"error": "Error message describing what went wrong"
}
Details zum Antwortformat
Wichtig: Der API kehrt immer zurück JSON, niemals direkt binäre Word-Daten.
Antwortstruktur:
{
"document": "string", // Base64-encoded Word document content
"fileName": "string", // Output Word filename
"success": true,
"errorMessage": "string or null"
}
Content-Type-Header:
- Erfolg:
application/json - Das Word-Dokument ist eingebettet als Base64 Zeichenkette innerhalb der JSON Antwort
Warum Base64?
- JSON-sichere Kodierung für Binärdaten
- Einfach zu übertragen über HTTP
- Kompatibel mit allen Programmiersprachen
- Kann direkt eingebettet werden in JSON ohne den Problemen auszuweichen
Dekodierung Base64 in Word-Dokument:
JavaScript/Node.js:
const base64 = response.document;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64'); // Node.js
Python:
import base64
word_bytes = base64.b64decode(response['document'])
with open('output.docx', 'wb') as f:
f.write(word_bytes)
C#:
byte[] wordBytes = Convert.FromBase64String(response.document);
File.WriteAllBytes("output.docx", wordBytes);
Beispiele für das Löschen von Seiten
Unterschiedliche Seitenlöschmuster verstehen:
| Dokumentseiten | Startseite | endPage | Seitenzahlen | Ergebnis |
|---|---|---|---|---|
| 1,2,3,4,5 | 2 | 4 | - | Portionen: 1,5 |
| 1,2,3,4,5 | 3 | - | - | Anzahl: 1,2 |
| 1,2,3,4,5 | - | - | "2,4" | Anzahl: 1, 3, 5 |
| 1,2,3,4,5 | 2 | 3 | "5" | Portionen: 1,4 |
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 verwendenAuthorization: Basic YWJjMTIz
Nutzlast
Einfaches Beispiel (Bereichslöschung):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 4
}
Beispiel für bestimmte Seiten:
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"pageNumbers": "2,4,6,8"
}
Erweitertes Beispiel (Kombinierte Löschung):
{
"document": { "Name": "document.docx" },
"docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
"startPage": 2,
"endPage": 5,
"pageNumbers": "7,9",
"cultureName": "en-US"
}
Codebeispiele
Der PDF4me Seiten aus Word löschen REST API Es werden Codebeispiele in verschiedenen Programmiersprachen bereitgestellt. Wählen Sie die Sprache, die am besten zu Ihrer Entwicklungsumgebung passt:
- C#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
C# (CSharp) Beispiel
Vollständig C# Implementierung zum Löschen von Seiten aus Word-Dokumenten:
Java Probe
Java Implementierung mit vollständiger Fehlerbehandlung und Antwortverarbeitung:
Python Probe
Python Implementierung mit der Requests-Bibliothek und JSON Handhabung:
Google Script Probe
Google Apps Script Implementierung für Google Workspace Integration:
Branchenspezifische Anwendungsfälle und Anwendungen
- Legal & Professional Services
- Business & Enterprise
- Education & Research
- Finance & Banking
Anwendungsfälle für Rechts- und Beratungsdienstleistungen
- Vertragsreinigung: Unterschriftenseiten und Anhänge aus den Vertragskopien entfernen
- Erstellung von RechtsdokumentenVertrauliche Seiten vor der Weitergabe an den Kunden löschen.
- Optimierung der GerichtsdokumentationEntfernen Sie unnötige Seiten, um die Einreichungsanforderungen zu erfüllen.
- Client-DokumentversionenErstellen Sie saubere Versionen, indem Sie interne Notizen entfernen.
Anwendungsfälle für Unternehmen und Organisationen
- Angebotsoptimierung: Entfernen Sie die internen Kostenseiten aus den Kundenangeboten.
- Bereinigung von Marketingmaterialien: Veraltete Inhaltsseiten aus den aktuellen Materialien löschen
- Präsentationsvorbereitung: Entfernen Sie Sicherungsfolien und Notizen aus den endgültigen Präsentationen.
- Optimierung der KundenergebnisseErstellen Sie saubere Versionen, indem Sie interne Verweise entfernen.
Anwendungsfälle in Bildung und Forschung
- Bereinigung medizinischer Berichte: Entfernen Sie Seiten mit sensiblen Patienteninformationen.
- Optimierung von ForschungsdokumentenVorläufige Daten aus den Abschlussberichten löschen
- Vorbereitung des Protokolldokuments: Entfernen Sie die Seiten für die interne Überprüfung aus den veröffentlichten Protokollen.
- Konformitätsdokumentation: Dokumente für behördliche Einreichungen aufbereiten
Anwendungsfälle im Finanz- und Bankwesen
- Bereinigung des Finanzberichts: Ausführliche Anhänge aus den Managementzusammenfassungen entfernen
- Optimierung der Budgetdokumente: Historische Datenseiten aus den aktuellen Budgets löschen
- Erstellung des Prüfberichts: Entfernen Sie sensible interne Seiten vor der externen Verteilung
- Bereinigung von behördlichen Einreichungen: Dokumente optimieren, um die Einreichungsanforderungen zu erfüllen