Geração de documentos usando cURL

Crie relatórios complexos baseados em dados com o GroupDocs.Assembly Cloud por meio de solicitações cURL simples.

  • GroupDocs.Assembly Cloud SDK for .NET
  • GroupDocs.Assembly Cloud SDK for Java
  • GroupDocs.Assembly Cloud SDK for C++
  • GroupDocs.Assembly Cloud SDK for Go
  • GroupDocs.Assembly Cloud SDK for Node.js
  • GroupDocs.Assembly Cloud SDK for PHP
  • GroupDocs.Assembly Cloud SDK for Python
  • GroupDocs.Assembly Cloud SDK for Ruby
  • GroupDocs.Assembly Cloud SDK for Swift
Iniciar teste gratuito

O GroupDocs.Assembly Cloud é um serviço de montagem de documentos totalmente gerenciado e baseado em nuvem que permite aos desenvolvedores criar documentos ricamente formatados, mesclando arquivos de modelo com dados estruturados. A solução funciona com uma ampla variedade de formatos de origem e saída — incluindo Microsoft Office, OpenDocument, PDF, HTML e formatos gráficos — para que você possa produzir contratos, faturas, propostas, relatórios ou qualquer outro documento comercial sob demanda.

O serviço é acessado por meio de uma API REST limpa, o que o torna ideal para integração com qualquer ambiente que possa emitir solicitações HTTP. Ao usar o cURL, o fluxo de trabalho consiste em três etapas simples:

  1. Carregar o modelo — Insira um arquivo DOCX, PPTX, HTML ou qualquer arquivo de modelo compatível no GroupDocs Cloud Storage por meio de uma solicitação PUT. O modelo contém campos de espaço reservado e regras de geração opcionais escritas em uma linguagem de expressão no estilo LINQ.
  2. Fornecer a fonte de dados — Forneça os dados que preencherão o modelo como um arquivo XML ou JSON. Os dados podem ser um conjunto simples de chave/valor ou uma estrutura hierárquica complexa contendo tabelas, coleções e imagens.
  3. Invocar o endpoint de montagem – Enviar uma solicitação POST que inclua o caminho para o modelo carregado, a fonte de dados e o formato de saída desejado (por exemplo, PDF, DOCX, HTML). A API processa o modelo, avalia todas as expressões, incorpora conteúdo externo, aplica fórmulas e retorna o documento montado diretamente na resposta ou o armazena no Cloud Storage.

Como todo o processo é executado na nuvem, nenhum software ou biblioteca adicional é necessário no lado do cliente — apenas uma instalação funcional do cURL. Toda a comunicação é protegida por SSL/TLS e a autenticação é realizada usando chaves de acesso pessoais. Essa abordagem permite prototipagem rápida, processamento em lote via mala direta e integração com pipelines de CI, mantendo a implementação simples e independente de plataforma.

As abas a seguir oferecem uma visão geral dos principais recursos, da lista completa de formatos de arquivo suportados e dos sistemas operacionais e ambientes de desenvolvimento compatíveis com o GroupDocs.Assembly Cloud.

Recursos da API REST do GroupDocs.Assembly

Crie documentos a partir de modelos com campos de espaço reservado

Vincular dados usando expressões no estilo LINQ

Suporte a fontes de dados XML e JSON

Incorporar conteúdo externo, imagens e gráficos

Gerar tabelas e listas dinâmicas

Inserir hiperlinks e marcadores

Aplicar fórmulas e operações sequenciais

Blocos de conteúdo condicional (IF/ELSE)

Variáveis reutilizáveis para cálculos caros

Cálculos de fórmulas específicas para planilhas

Atributos e anexos do corpo do e-mail

Gerar códigos de barras (QR, Code128, etc.)

Definir cores de fundo para saída HTML

Comunicação criptografada SSL/TLS

Autenticar com chaves de acesso pessoais

Gerar um documento em cURL

O snippet abaixo demonstra como carregar um arquivo de modelo e gerar um documento usando a API Assembly Cloud. Etapas:

  1. Carregue o modelo (Input1.docx) no Cloud Storage.
  2. Chame o endpoint assemble com o caminho do modelo, o formato de saída desejado e a fonte de dados (Input2.docx).
  3. Receba o documento montado no formato solicitado.
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" }'

Recursos de suporte e aprendizado

O GroupDocs.Assembly Cloud também oferece SDKs individuais para as plataformas listadas abaixo:

  Português