Documentos · API de HTML para PDF
Seu HTML vira PDF com qualidade de navegador.
Envie HTML e CSS e receba PDFs, PNGs ou JPGs renderizados por um Chromium real. Gere faturas, relatórios e certificados um a um ou em lotes com template, sem manter servidores de renderização.
curl -X POST 'https://api.respawntech.dev/v1/tools/document/pdf/convert' \
-H "X-API-Token: $RESPAWN_API_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"html": "<h1>Fatura #001</h1><p>Total: R$ 199,90</p>",
"format": "pdf",
"page_size": "A4",
"webhook_url": "https://seu-app.com/webhooks/pdf"
}'Casos de uso
Converta HTML e CSS em PDF, PNG ou JPG — um documento ou 500 de uma vez.
Faturas, recibos e boletos
Transforme o HTML que você já tem em documentos prontos para enviar ao cliente.
Relatórios com gráficos
Ative o JavaScript para renderizar gráficos e SPAs antes de gerar o PDF.
Certificados e contratos em massa
Um template, até 500 variações por lote, com desconto de volume.
Como funciona
Do cadastro à primeira chamada em minutos
Envie o HTML
POST com HTML, CSS e opções; receba o conversion_id com status 202.
Aguarde o webhook
Seu endpoint é chamado quando o job termina — sem polling.
Baixe o arquivo
Baixe o PDF (ou o ZIP do lote) pelo endpoint de download.
Recursos
Feita para rodar em produção
Renderização fiel
Chromium headless com suporte a CSS moderno, Google Fonts, cabeçalho e rodapé por página.
PDF, PNG ou JPG
Escolha o formato, o tamanho da página (A4, Letter, Legal), orientação, margens e escala.
Lotes com template
Envie um template com placeholders e até 500 itens; baixe tudo num ZIP.
Assíncrono de verdade
Receba 202 na hora e seja avisado por webhook quando o arquivo estiver pronto.
JavaScript em sandbox
Ative enable_js para páginas que dependem de script, com espera por seletor ou atraso.
Retenção sob controle
Arquivos efêmeros por ~24 h, retenção de até 30 dias ou permanente, armazenados de forma criptografada.
Preços
Pague pelo uso, não por assinatura
Cada documento parte de 1 crédito. Retenção acima de 3 dias e JavaScript são adicionais, e lotes a partir de 10 itens ganham desconto automático.
HTML para PDF — por documento
| Item | Créditos |
|---|---|
| Conversão base | 1,0 |
Retenção até 3 diasretention_days ≤ 3 | +0,0 |
Retenção de 4 a 7 diasretention_days 4–7 | +0,5 |
Retenção de 8 a 30 diasretention_days 8–30 | +2,5 |
Retenção permanenteretention_days: -1 | +15,0 |
JavaScript em sandboxenable_js | +0,25 |
HTML para PDF — desconto em lotes
| A partir de | Desconto |
|---|---|
| 10+ | 5% |
| 20+ | 10% |
| 30+ | 15% |
| 40+ | 20% |
Leituras via API (após a franquia diária)
Valores por consulta, cobrados apenas depois das leituras grátis do dia.
| Operação | Créditos |
|---|---|
| Listar conversões ou lotes | 0,005 |
| Status de conversão ou lote | 0,01 |
| Download de arquivo ou ZIP | 0,03 |
Casos de uso
O que dá para construir
FAQ
Perguntas frequentes
Quanto tempo leva uma conversão?
Documentos simples costumam ficar prontos em segundos. Como o processamento é assíncrono, use o webhook_url para ser avisado sem precisar consultar o status.
Posso usar fontes e imagens externas?
Sim. Use google_fonts_url para fontes do Google e URLs absolutas para imagens e folhas de estilo.
Por quanto tempo o arquivo fica disponível?
Por padrão, até 3 dias sem custo extra. Você pode escolher retenção efêmera (~24 h), até 30 dias ou permanente.
E se a conversão falhar?
O status indica o motivo em error_code. Você pode reprocessar a conversão; falhas não geram arquivo para download.
Comece a integrar hoje
Crie sua conta, gere um token e faça a primeira chamada em poucos minutos.