Build complex, data‑driven reports with GroupDocs.Assembly Cloud via straightforward cURL requests.
Start Free TrialGroupDocs.Assembly Cloud is a fully managed, cloud‑based document assembly service that lets developers create richly formatted documents by merging template files with structured data. The solution works with a wide range of source and output formats—including Microsoft Office, OpenDocument, PDF, HTML, and graphic formats—so you can produce contracts, invoices, proposals, reports, or any other business document on demand.
The service is accessed through a clean REST API, which makes it ideal for integration with any environment that can issue HTTP requests. When using cURL, the workflow consists of three straightforward steps:
PUT
request. The template contains placeholder fields and optional generation rules written in a LINQ‑style expression language.POST
request that includes the path to the uploaded template, the data source, and the desired output format (e.g., PDF, DOCX, HTML). The API processes the template, evaluates all expressions, embeds external content, applies formulas, and returns the assembled document directly in the response or stores it back to Cloud Storage.Because the entire process runs in the cloud, no additional software or libraries are required on the client side—only a working cURL installation. All communication is secured with SSL/TLS, and authentication is performed using personal access keys. This approach enables rapid prototyping, batch processing via mail‑merge, and integration into CI pipelines, while keeping the implementation simple and platform‑agnostic.
The following tabs provide a quick glance at the core capabilities, the exhaustive list of supported file formats, and the operating systems and development environments that are compatible with GroupDocs.Assembly Cloud.
The snippet below demonstrates how to upload a template file and generate a document using the Assembly Cloud API. Steps:
Input1.docx
) to Cloud Storage.Input2.docx
).curl -v "https://api.groupdocs.cloud/v1.0/assembly/storage/file/Input1.docx" \
-X PUT \
-H "Content-Type: multipart/form-data" \
-H "Authorization: Bearer ####################" \
-F FileContent="@Input1.docx"
curl -v "https://api.groupdocs.cloud/v1.0/assembly/assemble" \
-X POST \
-H "Content-Type: multipart/form-data" \
-H "Authorization: Bearer ####################" \
-d '{ "TemplateFileInfo": { "FilePath": "@Input1.docx" }, "SaveFormat": "docx", "ReportData": "@Input2.docx" }'