Dokumente zusammenführen – Dokumentenzusammenstellung API
PDF4me Dokumente zusammenführen Ermöglicht das Zusammenführen mehrerer Word-Dokumente zu einem einzigen Dokument mit erweiterten Formatierungs- und Konformitätsoptionen. API Der Dienst verarbeitet mehrere Word-Dateien und führt sie mit flexibler Dokumentreihenfolge, anpassbaren Formatierungsmodi, Einstellungen für Konformitätsstufen, Zeitzonenmetadaten und intelligenter Stilverwaltung zusammen. API empfängt Dokumentinhalte über REST API Anrufe, die genutzt werden Base64 Sichere Verschlüsselung für die Übertragung. Dank der Unterstützung für unbegrenztes Zusammenführen von Dokumenten und der vollständigen Kontrolle über das Zusammenführungsverhalten eignet sich diese Lösung ideal für die Dokumentenerstellung, Berichtskonsolidierung und Content-Management-Workflows.
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
- Unterstützung mehrerer Dokumente: Unbegrenzt viele Dokumente in einem zusammenführen
- Einfache Array-StrukturBenutzerfreundliches Array Base64-kodierter Dokumentinhalt
- Geordnete ZusammenführungDie Dokumente wurden in der Reihenfolge zusammengeführt, in der sie im Array erscheinen.
- BasisdokumentkonzeptDas erste Dokument bildet die Grundlage für die Zusammenführung.
- Unterstützung mehrerer FormateZusammenführen von Word-Dokumenten, PDFs und anderen unterstützten Formaten
REST API Endpunkt
Der PDF4me REST API verwendet Standard HTTP Methoden zur Interaktion mit Ressourcen. Alle Dokumentenzusammenführungsvorgänge werden über einen einzigen Endpunkt durchgeführt:
- Verfahren: POST
- Endpunkt:
office/ApiV2Word/MergeDocuments
REST API Parameter
Vollständige Liste der Parameter für die Zusammenführung von Dokumenten REST APIDie Parameter sind zur besseren Verständlichkeit und Implementierung nach Kategorien geordnet.
Wichtig: Mit einem Sternchen (*) gekennzeichnete Parameter sind Pflichtfelder. Unterlagen Das Array muss mindestens ein Dokument enthalten.
Erforderliche Parameter
| Parameter | Typ | Beschreibung | Beispiel |
|---|---|---|---|
| Unterlagen* | Array | Array von Dokumentobjekten, die zusammengeführt werden sollen. Muss mindestens ein Dokument enthalten. Jedes Objekt muss folgende Eigenschaften aufweisen: Dateiname (Zeichenkette) und docContent (Base64 Dokumente werden in der Reihenfolge ihres Erscheinens im Array zusammengeführt. Optionale Felder pro Dokument: Sortierposition (Ganzzahl), formatMode (Zeichenkette) | [{ "filename": "doc1.docx", "docContent": "base64..." }, { "filename": "doc2.docx", "docContent": "base64..." }] |
Optionale Parameter
| Parameter | Typ | Beschreibung | Beispiel |
|---|---|---|---|
| mergeOptions | Object | Zusammenführungsoptionen (Formatierung, Konformität usw.). Verfügbare Eigenschaften siehe Plugin-Modell. | {} |
Dokumentenzusammenführungsauftrag
Die Dokumente werden in der Reihenfolge zusammengeführt, in der sie erscheinen. Unterlagen Array:
- Das erste Dokument im Array wird zum Basisdokument
- Alle nachfolgenden Dokumente sind angehängt zum Basisdokument in Array-Reihenfolge
Ausgabe
Der PDF4me Dokumente zusammenführen 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": "merged-document.docx",
"success": true,
"errorMessage": null
}
Antwortfelder:
- dokumentieren (Zeichenkette): Das zusammengeführte Word-Dokument, das alle Eingabedokumente enthält, 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 (
UnterlagenArray) - Keine Dokumente zum Zusammenführen (leeres Dokumentenarray)
- Ungültig Base64 Kodierung im Dokumentinhalt
- Ungültige oder beschädigte Dokumente
- 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 Zusammenführen der Dokumente
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);
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 (zwei Dokumente):
{
"documents": [
{ "filename": "doc1.docx", "docContent": "base64EncodedDocument1" },
{ "filename": "doc2.docx", "docContent": "base64EncodedDocument2" }
]
}
Erweitertes Beispiel (Mehrere Dokumente mit Zusammenführungsoptionen):
{
"documents": [
{ "filename": "doc1.docx", "docContent": "base64EncodedDocument1" },
{ "filename": "doc2.docx", "docContent": "base64EncodedDocument2" },
{ "filename": "doc3.docx", "docContent": "base64EncodedDocument3" }
],
"mergeOptions": {}
}
Codebeispiele
Der PDF4me Dokumente zusammenführen 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) Probe
Vollständig C# Implementierung zum Zusammenführen von 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
- Vertragszusammenstellung: Die Vertragsabschnitte zu vollständigen Rechtsdokumenten zusammenfassen
- Zusammenfassung von Schriftsätzen: Zusammenführung mehrerer kurzer Abschnitte zu umfassenden juristischen Schriftsätzen
- Konformitätsdokumentation: Zusammenstellung der Compliance-Dokumente für die Einreichung bei den Aufsichtsbehörden
- Zusammenstellung der Kundendokumente: Kundenspezifische Dokumente zu kompletten Paketen zusammenfassen
Anwendungsfälle für Unternehmen und Organisationen
- Vorschlagsversammlung: Die einzelnen Angebotsabschnitte zu vollständigen Kundenangeboten zusammenfassen
- Konsolidierung von MarketingmaterialienZusammenführen von Marketingdokumenten für Kampagnen
- Verkaufspräsentations-Zusammenstellung: Kombinieren Sie Präsentationsabschnitte zu vollständigen Präsentationen
- Kundenlieferanten-Zusammenstellung: Kundenspezifische Materialien zusammenführen
Anwendungsfälle in Bildung und Forschung
- Zusammenstellung medizinischer Berichte: Zusammenfassen der einzelnen Abschnitte des medizinischen Berichts zu vollständigen Patientenberichten
- Protokolldokumentation: Zusammenführung von Protokollabschnitten zu umfassenden medizinischen Protokollen
- Forschungsdokumentation: Forschungsdokumente für Studienberichte zusammenfassen.
- Zusammenstellung des Handbuchs zur Einhaltung der Vorschriften: Zusammenführen von Dokumenten zur Einhaltung der Vorschriften im Gesundheitswesen
Anwendungsfälle im Finanz- und Bankwesen
- Zusammenstellung des Finanzberichts: Zusammenführen von Abschnitten aus Finanzberichten zu vollständigen Berichten
- Prüfdokumentation: Zusammenführung von Prüfungsdokumenten zu umfassenden Prüfungsberichten
- Haushaltskonsolidierung: Budgetabschnitte aus verschiedenen Abteilungen zusammenführen
- Zusammenstellung der regulatorischen Einreichungsunterlagen: Zusammenführung der regulatorischen Dokumente zur Einreichung