API de geração de PDF v1 – sem estado

API de geração de PDF
de modelos de negócios

Gere PDFs a partir de seus modelos HTML, DOCX, Markdown ou JSON. Retenção zero de dados – nenhum documento ou dado armazenado.

Obtenha sua chave de API Guia de início rápido

4 formatos de entrada

Substituição de variável

Armazenamento de dados zero

SLA de tempo de atividade de 99,9%

Início rápido

Obtenha seu primeiro PDF em menos de 2 minutos. Crie uma chave de API, envie uma solicitação e baixe o resultado.

Obtenha sua chave API

Crie uma chave de API no console abaixo ou no seu painel.

Sua chave de API é secreta. Nunca exponha isso no código frontend.

Envie sua primeira solicitação

Use o seguinte comando cURL para gerar um PDF:

Terminal

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<h1>Invoice #{{invoice_number}}</h1><p>Client: {{client_name}}</p><p>Amount: {{amount}}</p>",
    "variables": {
      "invoice_number": "2026-001",
      "client_name": "Acme Corp",
      "amount": "$1,250.00"
    }
  }' \
  --output invoice.pdf

Baixe seu PDF

A API retorna o binário PDF diretamente no corpo da resposta.

O PDF gerado é salvo no arquivo especificado no sinalizador --output.

Demonstração ao vivo

Experimente a API aqui: edite o conteúdo e as variáveis e clique em Gerar para ver seu PDF instantaneamente.

Faça login para experimentar a demonstração

Crie uma conta gratuita para acessar o playground ao vivo e gerar até 5 PDFs de demonstração.

Criar uma conta Entrar

Console de APIs

Gerencie suas chaves de API e monitore o uso diretamente nesta página.

É necessário fazer login

Faça login para criar e gerenciar suas chaves de API.

Criar uma conta Entrar

Autenticação

Todas as solicitações de API exigem uma chave de API enviada por meio do cabeçalho X-API-Key.

Como funciona

Crie uma chave de API no console ou painel.
Inclua-o em cada solicitação como cabeçalho X-API-Key.
A API valida sua chave e verifica sua cota.
Chaves inválidas ou revogadas retornam um erro 401.

Mantenha sua chave de API segura. Use variáveis de ambiente, nunca codifique no código-fonte.

Solicitação de exemplo

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_abc123def456..." \
  -H "Content-Type: application/json" \
  -d '{"format":"html","content":"<h1>Hello</h1>"}' \
  --output output.pdf

Resposta de chave inválida (401)

{
  "error": "invalid_api_key",
  "message": "The provided API key is invalid."
}

Formatos de entrada

EasyPDF suporta 4 formatos de entrada. Escolha aquele que melhor se adapta ao seu fluxo de trabalho.

HTML

Suporte CSS completo, pixel perfeito via Chromium

DOCX

Carregar modelos do Word com espaços reservados variáveis

Markdown

5 temas integrados para belos documentos

Template JSON

Mecanismo Canvas para controle preciso do layout

HTML → PDF

Principais recursos

Suporte completo a CSS3 (Flexbox, Grid, consultas de mídia)
Cabeçalhos e rodapés personalizados com números de página
Substituição de variável com sintaxe {{variable}}
Layouts responsivos com tamanhos de página A4/Carta/Ofício

Request body

{
  "format": "html",
  "content": "<html><head><style>body{font-family:Arial;padding:40px}h1{color:#333}.total{font-size:24px;font-weight:bold;color:#8b5cf6}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Date: {{date}}</p><p>Client: {{client_name}}</p><table><tr><th>Item</th><th>Price</th></tr><tr><td>{{item_1}}</td><td>{{price_1}}</td></tr></table><p class='total'>Total: {{total}}</p></body></html>",
  "variables": {
    "invoice_number": "2026-042",
    "date": "2026-03-16",
    "client_name": "Acme Corp",
    "item_1": "Web Development",
    "price_1": "$3,500",
    "total": "$4,700"
  },
  "options": { "page_format": "A4", "margin_top": "25mm" }
}

Terminais de API

Base URL: ${API_URL}/api/v1

POST/generate/pdfAPI Key

Gere um PDF a partir de conteúdo HTML, Markdown ou modelo JSON.

Request Body (JSON)

Parâmetro	Tipo	Obrigatória	Descrição
`format`	`string`	No	`"html"` (default), `"markdown"`, `"template"`
`content`	`string`	Yes*	String de conteúdo HTML ou Markdown (obrigatório para html/markdown)
`template_data`	`object`	Yes*	Objeto JSON de modelo (obrigatório para formato de modelo)
`variables`	`object`	No	Pares de valores-chave para substituição de variáveis
`options`	`object`	No	Opções de geração de PDF (formato de página, margens, etc.)

Resposta

200Content-Type: application/pdf

4xx/5xxContent-Type: application/json

POST/generate/pdf/uploadAPI Key

Carregue um arquivo DOCX para conversão em PDF com substituição de variável opcional.

Form Fields

Field	Tipo	Obrigatória	Descrição
`file`	File	Yes	O arquivo .docx para converter
`variables`	string (JSON)	No	Pares de valores-chave para substituição de variáveis
`options`	string (JSON)	No	Opções de PDF como string JSON

POST/generate/previewAPI Key

Gere uma visualização PNG da primeira página em vez de um PDF completo.

200Content-Type: image/png

GET/usageAPI Key

Verifique seu uso mensal atual e a cota restante.

Response (200)

{
  "month": "2026-03",
  "used": 142,
  "limit": 500,
  "remaining": 358,
  "plan": "starter"
}

POST/keysJWT Bearer

Crie uma nova chave de API (requer autenticação JWT).

GET/keysJWT Bearer

Liste todas as suas chaves de API com estatísticas de uso.

DELETE/keys/:key_idJWT Bearer

Revogar (desativar) uma chave de API permanentemente.

Exemplos de código

Exemplos completos e prontos para uso no idioma e formato de sua preferência. Selecione um idioma e formato de entrada abaixo.

curl — HTML

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<html><head><style>body{font-family:sans-serif;padding:40px}h1{color:#8b5cf6}table{width:100%;border-collapse:collapse}th,td{padding:8px 12px;border-bottom:1px solid #eee}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Client: <strong>{{client_name}}</strong></p><table><tr><th>Item</th><th>Amount</th></tr><tr><td>{{line_1}}</td><td>{{amount_1}}</td></tr></table><h2>Total: {{total}}</h2></body></html>",
    "variables": {
      "invoice_number": "INV-2026-042",
      "client_name": "Acme Corp",
      "line_1": "Web Development",
      "amount_1": "$3,500.00",
      "total": "$4,700.00"
    },
    "options": { "page_format": "A4", "margin_top": "20mm" }
  }' --output invoice.pdf

Casos de uso

Veja como as equipes usam a API EasyPDF para automatizar a geração de documentos em grande escala.

Faturas e recibos

Gere faturas de marca com itens de linha dinâmicos, totais e detalhes do cliente.

HTML / DOCX

Contratos e Acordos

Preencha modelos do Word com dados do cliente e converta em PDF para assinatura.

DOCX

Certificados e Diplomas

Crie certificados personalizados com layout e posicionamento precisos.

Template JSON

Relatórios e painéis

Transforme dados Markdown ou HTML em relatórios PDF sofisticados.

Markdown / HTML

Cartas e correspondências

Gere cartas personalizadas a partir de modelos DOCX para correspondências em massa.

DOCX

Documentos de Conformidade

Produza documentos de conformidade prontos para auditoria e à prova de falsificação.

HTML

Opções de PDF

Personalize a saída com estes parâmetros opcionais no objeto de opções.

Option	Tipo	Padrão	Descrição
`page_format`	`string`	`"A4"`	Tamanho da página: A4, Carta, Ofício, Tablóide ou personalizado
`landscape`	`boolean`	`false`	Ativar orientação paisagem
`margin_top`	`string`	`"20mm"`	Margem superior (unidades CSS: mm, cm, pol, px)
`margin_bottom`	`string`	`"20mm"`	Margem inferior
`margin_left`	`string`	`"15mm"`	Margem esquerda
`margin_right`	`string`	`"15mm"`	Margem direita
`header_html`	`string`	`null`	Conteúdo HTML para cabeçalho da página
`footer_html`	`string`	`null`	Conteúdo HTML para rodapé da página (suporta pageNumber, totalPages)
`theme`	`string`	`"modern"`	Tema Markdown: moderno, clássico, mínimo, github, acadêmico

Exemplo de opções completas

JSON

{
  "format": "html",
  "content": "<h1>Report</h1><p>Content here...</p>",
  "variables": {},
  "options": {
    "page_format": "A4",
    "landscape": false,
    "margin_top": "25mm",
    "margin_bottom": "25mm",
    "margin_left": "20mm",
    "margin_right": "20mm",
    "header_html": "<div style='text-align:right;font-size:9px'>Acme Corp — Confidential</div>",
    "footer_html": "<div style='text-align:center;font-size:9px'>Page <span class='pageNumber'></span> / <span class='totalPages'></span></div>",
    "theme": "modern"
  }
}

Tratamento de erros

A API retorna erros JSON estruturados com códigos de erro consistentes.

Formato de resposta de erro

{
  "error": "missing_content",
  "message": "The 'content' field is required for html format."
}

HTTP	Error	Quando	O que fazer
`400`	`missing_content`	Campo obrigatório ausente	Verifique os campos do corpo da solicitação
`400`	`invalid_json`	Falha na análise JSON	Valide sua carga JSON
`400`	`unsupported_format`	Valor de formato desconhecido	Use HTML, markdown ou modelo
`401`	`invalid_api_key`	Chave de API não encontrada	Verifique seu cabeçalho X-API-Key
`402`	`quota_exceeded`	Cota mensal excedida	Atualize seu plano ou aguarde a redefinição
`403`	`api_key_revoked`	A chave foi revogada	Crie uma nova chave de API
`429`	`rate_limit_exceeded`	Limite de taxa atingido	Aguarde e tente novamente com espera exponencial
`500`	`generation_failed`	Erro de processamento interno	Verifique se há erros no seu conteúdo e tente novamente

Limites de taxas e cotas

Cada plano tem uma cota mensal de PDF e um limite de taxa por minuto.

Limitação de taxa

As solicitações que excedem seu limite de taxa recebem uma resposta 429 com um cabeçalho Retry-After.

Resposta com taxa limitada

HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

Cotas Mensais

O uso é redefinido no primeiro dia de cada mês à meia-noite UTC.

Plan	PDFs/mês	Rate limit	Preço	Excedente
Starter	500	10/min	9€/mês	0,02€/PDF
Business	5 000	30/min	79€/mês	0,01€/PDF
Enterprise	Personalizada	Personalizada	Na cotação	Negociável

Melhores Práticas

Siga estas recomendações para aproveitar ao máximo a API.

Use variáveis para conteúdo dinâmico

Mantenha seus modelos estáticos e injete dados por meio do objeto variáveis. Isso é mais eficiente do que reconstruir o HTML a cada chamada.

Lidar com erros normalmente

Sempre verifique o código de status HTTP. Implemente novas tentativas com espera exponencial para erros 429 e 5xx.

Otimize seus modelos

Minimize o CSS, evite ativos externos (incorpore-os) e teste os modelos antes de implantar na produção.

Monitore seu uso

Use o endpoint /usage ou o console acima para rastrear o consumo e evitar limites de cota inesperados.

Proteja suas chaves de API

Armazene chaves em variáveis de ambiente ou gerenciadores de segredos. Gire as chaves periodicamente e revogue as não utilizadas.

Preços

Preços simples e transparentes. Pague apenas pelo que você usa.

Starter

9€/mês

~0,018€ / PDF

500 PDFs / mês
10 solicitações/min
Todos os 4 formatos de entrada
Geração de visualização PNG
Suporte por e-mail
Excedente : 0,02€/PDF

Comece

Melhor valor

Business

79€/mês

~0,016€ / PDF

5 000 PDFs / mês
30 solicitações/min
Todos os recursos iniciais
Suporte prioritário
Painel de análise de uso
Excedente : 0,01€/PDF