rustedf.cloud
Menu

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.

Terminal window
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.pdf

O 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.

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 URLs data:. 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 :hover ficam 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.

  • 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

    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

← Todos os posts