Cómo generar un PDF desde HTML con una sola petición
Publicado el 2 min de lectura
Si tu aplicación ya produce HTML, una factura, un informe, un certificado, convertirlo en
PDF debería ser una llamada, no un proyecto. Esta guía muestra esa llamada con la API de
rustedf.cloud, en curl y en Node.js, y qué comprobar antes de depender de ella.
La petición
Envía el HTML y los datos en el mismo POST /v1/render. El HTML se trata como una
plantilla: {{ name }} se sustituye por el valor de name en data.
curl -X POST https://api.rustedf.com/v1/render \ -H "Authorization: Bearer $RUSTEDF_KEY" \ -H "Content-Type: application/json" \ -d '{ "html": "<h1>Hola {{ name }}</h1>", "data": { "name": "Mundo" } }' \ -o hola.pdfEl PDF es el cuerpo de la respuesta, y -o hola.pdf lo guarda. Las cabeceras de la
respuesta indican cuántas páginas tiene (X-Pages) y cuántos créditos te quedan
(X-Credits-Remaining).
Pon los valores en data en lugar de construir tú mismo la cadena de HTML. Los valores se
escapan, así que un cliente llamado <b>Ana</b> aparece como texto y no rompe el diseño.
La misma llamada en Node.js
import { writeFile } from 'node:fs/promises';
const response = await fetch('https://api.rustedf.com/v1/render', { method: 'POST', headers: { Authorization: `Bearer ${process.env.RUSTEDF_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ html: '<h1>{{ title }}</h1><ul>{% for i in items %}<li>{{ i }}</li>{% endfor %}</ul>', data: { title: 'Lista de la compra', items: ['Pan', 'Leche'] }, }),});
if (!response.ok) throw new Error((await response.json()).error.message);await writeFile('lista.pdf', Buffer.from(await response.arrayBuffer()));Guarda la clave de API en tu servidor. Una petición hecha desde el navegador la expondría.
Un enlace en lugar del archivo
Si prefieres darle a tu cliente un enlace de descarga, pide "output": "url". La respuesta
es un JSON con un enlace firmado, que funciona sin clave de API hasta que caduca. Cuánto
tiempo se guardan los archivos depende de tu plan.
Qué saber antes de salir a producción
- Imágenes. Un documento puede usar imágenes PNG y JPEG que hayas subido (
asset:<id>) o imágenes incrustadas como URLdata:. Un<img>que apunta a una dirección web se omite y se informa, porque el servicio nunca descarga una dirección que venga de una plantilla. - CSS. Los documentos se componen para el papel: páginas, tablas que continúan en
varias páginas, encabezados y pies. JavaScript, animaciones y
:hoverquedan fuera. Lo que no se admite se ignora y se informa, no se convierte en un fallo. - Créditos. Una generación correcta cuesta un crédito. Una que falla no cuesta nada.
- Límites. El tamaño de la entrada, el número de páginas y el tiempo están limitados por plan, y una petición que los supera se rechaza con un error claro.
Comprueba un documento antes de que cuente
POST /v1/validate recibe el mismo cuerpo, construye el documento y te dice qué no admitió
el servicio por completo, sin devolver el PDF y sin gastar un crédito. Añade
"strict": true a una generación para convertir esos mismos avisos en un error, algo útil
en las pruebas.
Cuándo conviene una plantilla guardada
El HTML directo sirve para documentos sueltos y para HTML que viene de otro sistema. Si el
mismo diseño se genera con frecuencia, guárdalo como plantilla en el portal, con vista
previa en vivo, y llámalo por su id. La petición es la misma, con template_id en lugar de
html.
A continuación, lee Generar un PDF para ver todas las opciones y Generar con HTML directo para este mismo flujo.
Sigue leyendo
Primeros pasos
HTML y CSS para PDF: qué funciona y cómo comprobarlo
Un PDF está paginado, no se desplaza. Mira qué HTML y CSS admite un generador de PDF, qué dejar fuera y cómo validar un documento antes de enviarlo.
3 min de lectura
Primeros pasos
HTML a PDF: ¿biblioteca, navegador headless o API? Cómo elegir
Tres formas de convertir HTML en PDF, qué pide cada una que ejecutes y mantengas, qué HTML y CSS obtienes, y una lista corta de preguntas que deciden.
4 min de lectura
Primeros pasos
Cómo generar una factura en PDF con una API
Crea una plantilla de factura con líneas en bucle, moneda y fecha por país, y genera el PDF con una petición. Ejemplo completo en HTML y curl.
2 min de lectura
Código e integraciones
Generar un PDF en ASP.NET Core: MVC, Razor Pages y minimal APIs
Convierte una vista Razor en PDF en ASP.NET Core con una llamada a la API: renderizador de vistas, vista lista para imprimir, acción MVC y handler de Razor Pages.
3 min de lectura