rustedf.cloud
Menu

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 os
import 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.content

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

Uma geração que falha não custa crédito, então tentar de novo é seguro.

No Django

from django.conf import settings
from 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 FastAPI
from 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.

  • 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

← Todos os posts