Como gerar PDF a partir de HTML com uma única requisição
Publicado em 2 min de leitura
Se a sua aplicação já produz HTML, uma fatura, um relatório, um certificado, transformá-lo
em PDF deveria ser uma chamada, não um projeto. Este guia mostra essa chamada com a API do
rustedf.cloud, em curl e em Node.js, e o que conferir antes de depender dela.
A requisição
Envie o HTML e os dados no mesmo POST /v1/render. O HTML é tratado como um template:
{{ name }} é trocado pelo valor de name em data.
curl -X POST https://api.rustedf.com/v1/render \ -H "Authorization: Bearer $RUSTEDF_KEY" \ -H "Content-Type: application/json" \ -d '{ "html": "<h1>Olá {{ name }}</h1>", "data": { "name": "Mundo" } }' \ -o ola.pdfO PDF é o corpo da resposta, e -o ola.pdf o salva. Os cabeçalhos da resposta dizem
quantas páginas ele tem (X-Pages) e quantos créditos restam (X-Credits-Remaining).
Coloque os valores em data em vez de montar a string de HTML por conta própria. Os valores
são escapados, então um cliente chamado <b>Ana</b> aparece como texto e não quebra o
layout.
A mesma chamada em Node.js
import { writeFile } from 'node:fs/promises';
const response = await fetch('https://api.rustedf.com/v1/render', { method: 'POST', headers: { Authorization: `Bearer ${process.env.RUSTEDF_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ html: '<h1>{{ title }}</h1><ul>{% for i in items %}<li>{{ i }}</li>{% endfor %}</ul>', data: { title: 'Lista de compras', items: ['Pão', 'Leite'] }, }),});
if (!response.ok) throw new Error((await response.json()).error.message);await writeFile('lista.pdf', Buffer.from(await response.arrayBuffer()));Mantenha a chave de API no seu servidor. Uma requisição feita do navegador a exporia.
Um link em vez do arquivo
Se você prefere entregar ao seu cliente um link para baixar, peça "output": "url". A
resposta é um JSON com um link assinado, que funciona sem chave de API até expirar. Por
quanto tempo os arquivos ficam guardados depende do seu plano.
O que saber antes de colocar em produção
- Imagens. Um documento pode usar imagens PNG e JPEG que você enviou (
asset:<id>) ou imagens embutidas como URLsdata:. Um<img>que aponta para um endereço da web é ignorado e reportado, porque o serviço nunca busca um endereço vindo de um template. - CSS. Os documentos são montados para o papel: páginas, tabelas que seguem por várias
páginas, cabeçalhos e rodapés. JavaScript, animações e
:hoverficam de fora. Tudo o que não é suportado é ignorado e reportado, não vira uma falha. - Créditos. Uma geração bem-sucedida custa um crédito. Uma que falha não custa nada.
- Limites. O tamanho da entrada, o número de páginas e o tempo são limitados por plano, e uma requisição que passa deles é recusada com um erro claro.
Confira um documento antes de ele contar
POST /v1/validate recebe o mesmo corpo, monta o documento e diz o que o serviço não
suportou por completo, sem devolver o PDF e sem usar crédito. Acrescente "strict": true
a uma geração para transformar esses mesmos avisos em erro, o que ajuda nos testes.
Quando um template salvo é melhor
HTML direto serve para documentos avulsos e para HTML que vem de outro sistema. Se o mesmo
layout é gerado com frequência, salve-o como template no portal, com pré-visualização ao
vivo, e chame-o pelo id. A requisição é a mesma, com template_id no lugar de html.
Em seguida, leia Gerar um PDF para ver todas as opções e Gerar com HTML direto para este mesmo fluxo.
Continue lendo
Primeiros passos
HTML e CSS para PDF: o que funciona e como conferir
Um PDF é paginado, não rolado. Veja quais HTML e CSS um gerador de PDF suporta, o que deixar de fora e como validar um documento antes de enviar.
3 min de leitura
Primeiros passos
HTML para PDF: biblioteca, navegador headless ou API? Como escolher
Três jeitos de transformar HTML em PDF, o que cada um pede para rodar e manter, que HTML e CSS você recebe, e uma lista curta de perguntas que decidem.
4 min de leitura
Primeiros passos
Como gerar fatura em PDF com uma API
Monte um template de fatura com itens em loop, moeda e data por país, e gere o PDF com uma requisição. Exemplo completo em HTML e curl.
2 min de leitura
Código e integrações
Gerar PDF no ASP.NET Core: MVC, Razor Pages e minimal APIs
Transforme uma view Razor em PDF no ASP.NET Core com uma chamada de API: renderizador de views, view pronta para impressão, action MVC e handler do Razor Pages.
3 min de leitura