Un PDF desde la API, sin navegador

GET /api/v1/documents/:id.pdf maqueta un documento como PDF en el servidor, para un script o un trabajo de integración continua que no tiene navegador desde el que imprimir. La propia aplicación sigue usando «Imprimir o guardar como PDF» para eso — es la representación exacta del navegador, y esto no la sustituye.

GET /api/v1/documents/:id.pdf, con una clave de API, devuelve un PDF maquetado de un documento guardado. Está pensado para el caso en el que no hay ningún navegador: una tarea programada, un paso de integración continua que adjunta un informe a una versión, un script que envía un resumen semanal.

Por qué existe aparte de imprimir

La mayoría de las herramientas de Markdown a PDF son un Chrome sin cabeza con gabardina. Eso da una representación exacta y cuesta un navegador: varios cientos de megabytes de dependencia, un entorno aislado donde encerrarlo, un arranque por petición y un techo de memoria que un documento largo alcanza antes que una persona. Nada de eso cabe en una función serverless, y un servicio que arranca en silencio un navegador por petición es un servicio lento y caro para el único caso que podría no haber sido ninguna de las dos cosas.

Aquí el documento se maqueta directamente — encabezados, párrafos, listas, tablas, bloques de código y filetes — sin navegador en ninguna parte del camino. Arranca de inmediato y termina en milisegundos.

Lo que no es

No es una copia píxel a píxel de la vista previa. La opción Imprimir o guardar como PDF de la aplicación sigue usando la representación propia del navegador, que es exacta, y eso no ha cambiado: si quieres la página tal como la ves, imprímela. Si quieres un PDF desde una máquina, pídelo.

Cómo se usa

curl -H "Authorization: Bearer tp_live_…" \
  https://transformpipe.com/api/v1/documents/<id>.pdf -o report.pdf

El mismo documento está disponible como .docx, .html y .md cambiando la extensión, así que un documento guardado son cuatro formatos sin una segunda conversión.

Relacionado: los caminos de Markdown al PDF y convertir documentos con una API.