rustedf.cloud
Menú

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.

Terminal window
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.pdf

El 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 URL data:. 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 :hover quedan 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.

← Todos los artículos