Ein PDF aus der API, ohne Browser

GET /api/v1/documents/:id.pdf setzt ein Dokument auf dem Server als PDF, für ein Skript oder einen CI-Lauf, der keinen Browser zum Drucken hat. Die App selbst nutzt dafür weiterhin „Drucken oder als PDF sichern" — das ist die exakte Darstellung des Browsers, und dies ersetzt sie nicht.

GET /api/v1/documents/:id.pdf liefert mit einem API-Schlüssel ein gesetztes PDF eines gespeicherten Dokuments. Gedacht ist es für den Fall, in dem kein Browser vorkommt: ein geplanter Job, ein CI-Schritt, der einem Release einen Bericht anhängt, ein Skript, das eine Wochenübersicht verschickt.

Warum das getrennt vom Drucken existiert

Die meisten Werkzeuge von Markdown nach PDF sind ein Headless-Chrome im Trenchcoat. Das ergibt eine exakte Darstellung und kostet einen Browser: mehrere hundert Megabyte Abhängigkeit, eine Sandbox, in der er bleibt, ein Start pro Anfrage und eine Speichergrenze, die ein langes Dokument früher erreicht als ein Mensch. Nichts davon passt in eine Serverless-Funktion, und ein Dienst, der still pro Anfrage einen Browser startet, ist langsam und teuer für den einen Fall, der weder das eine noch das andere hätte sein müssen.

Hier wird das Dokument direkt gesetzt — Überschriften, Absätze, Listen, Tabellen, Codeblöcke und Linien —, ohne Browser irgendwo im Weg. Es startet sofort und ist in Millisekunden fertig.

Was es nicht ist

Es ist keine pixelgenaue Kopie der Vorschau. Drucken oder als PDF sichern in der App benutzt weiterhin die Darstellung des Browsers selbst, die exakt ist, und daran ändert sich nichts: Wenn Sie die Seite so wollen, wie Sie sie sehen, drucken Sie sie. Wenn Sie ein PDF von einer Maschine wollen, fragen Sie danach.

So benutzen Sie es

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

Dasselbe Dokument gibt es als .docx, .html und .md, indem Sie die Endung ändern — ein gespeichertes Dokument sind also vier Formate ohne eine zweite Konvertierung.

Weiter: die Wege von Markdown zum PDF und Dokumente über eine API konvertieren.