Gerar com um template salvo

Use um template salvo quando o mesmo documento é gerado muitas vezes, como faturas, orçamentos ou relatórios. O layout fica na sua conta; cada requisição leva só os dados que mudam.

1. Salve o template

Crie no portal, em Templates, com pré-visualização ao vivo, ou pela API:

curl -X POST https://api.example.com/v1/templates \
  -H "Authorization: Bearer $RUSTEDF_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Fatura", "source": "<h1>Fatura {{ number }}</h1><p>{{ total | currency(code=\"BRL\") }}</p>",
        "locale": "pt-BR", "sample_data": { "number": "2025-0042", "total": "2040.50" } }'

A resposta traz o id do template. Veja a sintaxe em Templates.

2. Gere o documento

Envie o id e os dados:

curl -X POST https://api.example.com/v1/render \
  -H "Authorization: Bearer $RUSTEDF_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "template_id": "0194f2c0-…", "data": { "number": "2025-0042", "total": "2040.50" } }' \
  -o fatura.pdf

O locale do template é usado, a menos que a requisição envie o seu. Assim um template serve a todos os mercados: envie "locale": "de-DE" e a mesma fatura sai formatada para a Alemanha.

Por que usar

• O HTML não viaja a cada requisição, então elas ficam pequenas.
• Designers e desenvolvedores editam o template no portal e testam com dados de exemplo, sem deploy do seu lado.
• Cada alteração aumenta a version do template, e a próxima geração já usa a nova.
• Os templates são privados da sua conta; o id de outra conta responde 404.

O seu plano limita quantos templates você pode guardar; veja Planos e créditos. Para a lista completa de campos e a resposta, veja Gerar um PDF. Se preferir enviar o HTML você mesmo, veja Com HTML direto.