Das Zusammenführen von PDFs ermöglicht es Ihnen, zusätzliche PDF-Dateien am Ende Ihrer generierten Dokumente anzuhängen – ideal, um ergänzende Informationen, Allgemeine Geschäftsbedingungen, Anhänge oder andere relevante Inhalte einzubinden. Diese Funktion ist besonders nützlich für Dokumente, die dynamisch generierte Inhalte mit statischen PDF-Materialien kombinieren.
Mit der DocuGenerate-API können Sie PDF-Dateien beim Aufruf des Dokument generieren-Endpunkts mit dem merge_with-Parameter zusammenführen. Die PDF-Dateien können als URL oder als Base64-kodierter Data-URI angegeben werden. Dieser Parameter gilt nur, wenn output_format .pdf ist (oder eine PDF/A-Version wie .pdf/a-1b, .pdf/a-2b oder .pdf/a-3b).
Obwohl es auch möglich ist, eine einzelne PDF-Datei über die Weboberfläche zusammenzuführen, bietet die API zusätzliche Flexibilität, indem mehrere PDF-Dateien in einer einzigen Anfrage unterstützt werden.
PDF-Datei per URL Zusammenführen
Um eine PDF-Datei von einer URL zusammenzuführen, geben Sie den merge_with-Parameter mit der URL der Datei an, zum Beispiel https://pdfobject.com/pdf/sample.pdf:
curl -X 'POST' \
'https://api.docugenerate.com/v1/document' \
-H 'accept: application/json' \
-H 'Authorization: 491c000c5fad32ed7787005b0723ad55' \
-H 'Content-Type: multipart/form-data' \
-F 'template_id=7VYocxLnIupLU3YT4iLr' \
-F 'merge_with=https://pdfobject.com/pdf/sample.pdf' \
-F 'data={ "Company Name": "Acme Corp", "Invoice No": "INV-123456", "Street Address": "123 Main St", "City": "Springfield", "State": "IL", "Zip Code": "62701", "Invoice Date": "2025-02-26", "Phone": "(555) 123-4567", "Description": "Consulting services for Q1 2025", "Quantity": "10", "Amount": "150.00", "Total": "1500.00" }' \
-F 'output_format=.pdf'
Das angegebene PDF wird am Ende des generierten Dokuments eingefügt. Wenn die URL nicht gefunden wird oder nicht auf eine gültige PDF-Datei verweist, wird sie beim Zusammenführen ignoriert. Sie können eine Kopie des generierten PDFs hier herunterladen.
PDF-Datei per Base64-kodiertem Data-URI Zusammenführen
Um eine PDF-Datei mit einem Base64-kodierten Data-URI zusammenzuführen, können Sie den PDF-Inhalt direkt in der Anfrage bereitstellen. Hier ist ein Beispiel mit einem Base64-kodierten PDF:
curl -X 'POST' \
'https://api.docugenerate.com/v1/document' \
-H 'accept: application/json' \
-H 'Authorization: 491c000c5fad32ed7787005b0723ad55' \
-H 'Content-Type: multipart/form-data' \
-F 'template_id=7VYocxLnIupLU3YT4iLr' \
-F 'merge_with="data:application/pdf;base64,JVBERi..."' \
-F 'data={ "Company Name": "Acme Corp", "Invoice No": "INV-123456", "Street Address": "123 Main St", "City": "Springfield", "State": "IL", "Zip Code": "62701", "Invoice Date": "2025-02-26", "Phone": "(555) 123-4567", "Description": "Consulting services for Q1 2025", "Quantity": "10", "Amount": "150.00", "Total": "1500.00" }' \
-F 'output_format=.pdf'
Dieser Ansatz ist nützlich, wenn Sie PDF-Inhalte zusammenführen müssen, die programmatisch gespeichert oder generiert werden, ohne externes Datei-Hosting zu benötigen.
Mehrere PDF-Dateien Zusammenführen
Der merge_with-Parameter unterstützt auch ein Array von PDF-Dateien, mit dem Sie mehrere PDFs am Ende Ihres generierten Dokuments zusammenführen können. Sie können URLs und Base64-kodierte Data-URIs im selben Array mischen.
Hier ist ein Beispiel für das Zusammenführen mehrerer PDF-Dateien mit einem Array von URLs:
curl -X 'POST' \
'https://api.docugenerate.com/v1/document' \
-H 'accept: application/json' \
-H 'Authorization: 491c000c5fad32ed7787005b0723ad55' \
-H 'Content-Type: multipart/form-data' \
-F 'template_id=7VYocxLnIupLU3YT4iLr' \
-F 'merge_with=["https://pdfobject.com/pdf/sample.pdf", "https://pdf-lib.js.org/assets/with_update_sections.pdf"]' \
-F 'data={ "Company Name": "Acme Corp", "Invoice No": "INV-123456", "Street Address": "123 Main St", "City": "Springfield", "State": "IL", "Zip Code": "62701", "Invoice Date": "2025-02-26", "Phone": "(555) 123-4567", "Description": "Consulting services for Q1 2025", "Quantity": "10", "Amount": "150.00", "Total": "1500.00" }' \
-F 'output_format=.pdf'
Das generierte PDF-Dokument enthält zusätzliche Seiten aus den zwei zusammengeführten PDF-Dateien. Sie können eine Kopie des generierten PDFs hier herunterladen.
Sie können auch mehrere URLs und Data-URIs im selben API-Aufruf kombinieren:
curl -X 'POST' \
'https://api.docugenerate.com/v1/document' \
-H 'accept: application/json' \
-H 'Authorization: 491c000c5fad32ed7787005b0723ad55' \
-H 'Content-Type: multipart/form-data' \
-F 'template_id=7VYocxLnIupLU3YT4iLr' \
-F 'merge_with[]=https://pdfobject.com/pdf/sample.pdf' \
-F 'merge_with[]="data:application/pdf;base64,JVBERi..."' \
-F 'data={ "Company Name": "Acme Corp", "Invoice No": "INV-123456", "Street Address": "123 Main St", "City": "Springfield", "State": "IL", "Zip Code": "62701", "Invoice Date": "2025-02-26", "Phone": "(555) 123-4567", "Description": "Consulting services for Q1 2025", "Quantity": "10", "Amount": "150.00", "Total": "1500.00" }' \
-F 'output_format=.pdf'
Wenn mehrere PDF-Dateien im merge_with-Array angegeben werden, werden sie in der Reihenfolge zusammengeführt, in der sie im Array erscheinen. Wenn eine per URL angegebene PDF-Datei nicht gefunden wird oder nicht zugänglich ist, wird diese Datei ignoriert und die Zusammenführung wird mit den verbleibenden Dateien fortgesetzt. Wenn eine PDF-Datei beschädigt oder ungültig ist, wird sie beim Zusammenführen übersprungen.
Batch-Dokumentgenerierung
Wenn Sie mehrere Dokumente generieren, indem Sie single_file auf false setzen, erstellt DocuGenerate eine .zip-Datei, die alle generierten Dokumente enthält. Jedes Dokument in der .zip-Datei entspricht einem separaten Datenelement und behält das gewählte Exportformat bei.
In diesem Fall werden die in merge_with angegebenen PDF-Dateien am Ende jedes generierten Dokuments eingefügt. Dadurch wird sichergestellt, dass ergänzende Inhalte konsistent in allen generierten Dateien enthalten sind.
Mit der DocuGenerate-API ist das Zusammenführen von PDF-Dateien mit Ihren generierten Dokumenten einfach und flexibel, egal ob Sie eine einzelne Datei oder mehrere Dateien verwenden und ob Sie direkte URLs oder Base64-kodierte Data-URIs nutzen. Diese Funktion ermöglicht es Ihnen, umfassende Dokumente zu erstellen, die dynamische Inhalte mit statischen ergänzenden Materialien kombinieren – alles in einem einzigen API-Aufruf.