Como gerar PDF a partir de HTML em Python
Publicado em 2 min de leitura
Em Python, transformar HTML em PDF costuma significar instalar uma biblioteca de renderização
e as suas dependências do sistema, e depois mantê-las funcionando em cada ambiente. Com uma API,
é uma requisição HTTP, que o requests já faz bem. Este guia mostra uma função pequena e como
usá-la em Django e FastAPI, com a API do rustedf.cloud.
Uma função que devolve o PDF
import osimport requests
API = "https://api.rustedf.com/v1/render"
def render_pdf(template_id: str, data: dict, locale: str = "pt-BR") -> bytes: response = requests.post( API, headers={"Authorization": f"Bearer {os.environ['RUSTEDF_KEY']}"}, json={"template_id": template_id, "locale": locale, "data": data}, timeout=40, ) if response.status_code != 200: error = response.json().get("error", {}) raise RuntimeError(error.get("message", f"Falha ao gerar ({response.status_code})")) return response.contentO json= define o cabeçalho Content-Type por você. Uma resposta bem-sucedida é o próprio PDF,
então response.content são os bytes do arquivo. Em uma falha, o corpo é um JSON com um code
estável e uma message.
Guarde a chave em uma variável de ambiente. Defina o tempo limite acima do limite do seu plano, para que a sua requisição não desista antes do serviço.
Para enviar o HTML em vez do id de um template salvo, use {"html": "<h1>{{ name }}</h1>", "data": {...}}.
Passe tudo o que um usuário digitou por data, nunca dentro da string de HTML: os valores em
data são escapados, e o próprio HTML é lido como um template.
Tentar de novo quando o serviço está ocupado
Um 429 (limite de requisições) ou um 503 (ocupado) traz um cabeçalho Retry-After. Um laço
curto basta:
import time
def render_pdf_with_retry(template_id, data, locale="pt-BR", attempts=3): for attempt in range(attempts): response = requests.post( API, headers={"Authorization": f"Bearer {os.environ['RUSTEDF_KEY']}"}, json={"template_id": template_id, "locale": locale, "data": data}, timeout=40, ) if response.status_code in (429, 503) and attempt < attempts - 1: try: wait = int(response.headers.get("Retry-After", "2")) except ValueError: wait = 2 time.sleep(wait) continue break if response.status_code != 200: error = response.json().get("error", {}) raise RuntimeError(error.get("message", f"Falha ao gerar ({response.status_code})")) return response.contentUma geração que falha não custa crédito, então tentar de novo é seguro.
No Django
from django.conf import settingsfrom django.http import HttpResponse
def fatura_pdf(request, numero): pdf = render_pdf(settings.RUSTEDF_INVOICE_TEMPLATE, montar_dados_da_fatura(numero), "pt-BR") return HttpResponse( pdf, content_type="application/pdf", headers={"Content-Disposition": f'inline; filename="fatura-{numero}.pdf"'}, )No FastAPI
from fastapi import FastAPIfrom fastapi.responses import Response
app = FastAPI()
@app.get("/faturas/{numero}.pdf")def fatura_pdf(numero: str): pdf = render_pdf(INVOICE_TEMPLATE, montar_dados_da_fatura(numero), "pt-BR") return Response(content=pdf, media_type="application/pdf")A função é um def comum, então o FastAPI a executa em uma thread de trabalho e a chamada
bloqueante não trava o laço de eventos.
Erros que vale tratar
| Status | code |
O que fazer |
|---|---|---|
| 401 | unauthorized |
A chave está ausente, errada ou revogada. |
| 402 | insufficient_credits |
Os créditos acabaram. Nada foi gerado. |
| 422 | invalid_template |
O template ou os dados falharam. Leia a message. |
| 429 | rate_limited |
Espere o Retry-After e tente de novo. |
| 503 | busy |
O serviço está ocupado. Espere o Retry-After e tente de novo. |
| 504 | render_timeout |
O documento levou mais do que o seu plano permite. |
Antes de depender de um template, rode POST /v1/validate com o mesmo corpo: ele lista tudo o
que o serviço não suportou por completo, sem devolver o PDF nem usar crédito.
Leia Gerar um PDF, Autenticação e Erros e limites.
Continue lendo
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
Código e integrações
Converter página web em PDF em C# sem navegador headless
Busque uma página com HttpClient e transforme o HTML em PDF com uma chamada de API em C#. Quais páginas isso atende, quais não e como conferir antes de depender.
3 min de leitura
Código e integrações
Gerador de relatório PDF em C#: tabela paginada com totais
Monte um relatório em PDF em C# a partir de uma lista de objetos: tabela com cabeçalho repetido em cada página, total, número de página e contagem de páginas.
3 min de leitura
Código e integrações
Salvar PDF em C#: em disco, como download ou em blob storage
Salve o PDF devolvido por uma chamada de renderização em C#: grave em disco, envie como download no ASP.NET Core, guarde um link assinado ou suba para o storage.
2 min de leitura