Abrechnungen und Zahlungsavise
Periodische Abrechnungen und Zahlungsavise, gerendert aus derselben Vorlage, die Ihre Kontoansichten bereits verwenden.
HTML-zu-PDF-API für produktionsreife Dokumente
Erzeugen Sie Abrechnungen, Berichte, Verträge und Zertifikate aus dem HTML und CSS, das Ihre Anwendung bereits rendert. Eine Anfrage hinein, ein fertiges Dokument zurück, mit dem Papierformat, den Rändern und den wiederkehrenden Elementen, die Sie festlegen.
Kostenloses Konto erstellenAPI-Dokumentation lesen
- 100 kostenlose PDFs pro Monat
- Jede Seitengröße
- Keine Kosten für fehlgeschlagene Renderings
- Im Vereinigten Königreich betriebene Infrastruktur
A4
Seite 1 von 3
Eine Anfrage
Dieses Dokument haben Sie schon einmal gebaut
Die meisten PDF-Bibliotheken verlangen, dass Sie ein Layout, das Sie schon in HTML und CSS geschrieben haben, in einer Zeichen-API mit eigenen Einheiten, Schriften und eigenem Boxmodell nachbauen. Das Dokument auf dem Bildschirm und das Dokument im Anhang laufen dann auseinander, und jede Änderung kostet doppelt.
Ironfang Render druckt das Markup, das Sie bereits haben, in einem echten Browser, mit Papierformat, Rändern, Skalierung sowie wiederkehrender Kopf- und Fußzeile pro Anfrage. Eine Vorlage, zwei Ausgaben, ein Ort für Änderungen.
POST /render/v1/pdf
Authorization: Bearer if_live_...
Content-Type: application/json
{
"html": "<html>...your document...</html>",
"paper_format": "a4",
"print_background": true,
"margin": { "top": 0.6, "bottom": 0.8 },
"header_html": "<span></span>",
"footer_html": "<p style='font-size:9px'>Page <span class='pageNumber'></span></p>"
}
200 OK
Content-Type: application/pdfFunktionen
Dokumenteinstellungen als Anfrageparameter
Die Druckeinstellungen, denen Sie sonst in einem Browserdialog hinterherlaufen würden, pro Anfrage gesetzt und jedes Mal identisch.
Ihr HTML und CSS
Drucken Sie das Markup, das Ihre Anwendung bereits erzeugt, oder speichern Sie es als Dokumentvorlage und rendern Sie es mit JSON-Daten, geprüft gegen ein Schema, aus nummerierten Revisionen, die Sie veröffentlichen und zurücksetzen. Keine PDF-spezifische Layoutbibliothek, keine zweite Implementierung eines Dokuments, das Sie schon einmal gebaut haben.
Jede Seitengröße, die Seiten, die Sie brauchen
A3, A4, A5, Letter, Legal und Tabloid oder ein eigenes Format in Millimetern oder Zoll, im Hoch- oder Querformat, mit Rändern und Skalierungsfaktor pro Anfrage. Behalten Sie nur die Seiten, die Sie nennen, und legen Sie Titel und Autor fest, die ein PDF-Viewer anzeigt.
Wiederkehrende Kopf- und Fußzeilen
Liefern Sie HTML für Kopf- und Fußzeile, und es erscheint auf jeder Seite, dort, wo Seitenzahlen, Logos und Dokumentreferenzen hingehören.
Hintergründe, die den Druck überstehen
Schalten Sie das Drucken von Hintergründen ein, und Ihre Tönungen, Flächen und Markenfarben bleiben erhalten, statt so wegzufallen, wie ein Browser sie weglässt.
Dokumente hinter einem Login
Dieselben Header, derselbe Authorization-Header und dieselben Cookies wie bei einer Screenshot-Anfrage, sodass sich eine Abrechnung hinter einem Login so leicht drucken lässt wie eine öffentliche Seite.
Direkte binäre Antwort
Das PDF kommt in der Antwort zurück. Kein Job, den Sie abfragen, kein Bucket, aus dem Sie lesen müssen, es sei denn, Sie möchten für lange Dokumente den asynchronen Weg.
Anwendungsfälle
Dokumente, die man besser erzeugt, statt sie zweimal zu gestalten
Überall dort, wo Ihre Anwendung den Inhalt bereits rendert und jemand ihn als Datei braucht.
Bestellbestätigungen
Hängen Sie eine druckbare Bestätigung an die E-Mail, die Ihre Anwendung ohnehin versendet, erzeugt mit einer einzigen Anfrage.
Berichte und Exporte
Machen Sie aus einem Dashboard oder einer Berichtsseite ein Dokument, das jemand ablegen, drucken oder weiterleiten kann.
Zertifikate und Pässe
Personalisieren Sie pro Empfänger mit Variablen und fügen Sie einen geprüften QR-Code ins Layout ein.
Verträge und Briefe
Erzeugen Sie einheitliche Dokumente in Ihrem Design aus HTML statt aus einer Textverarbeitungsvorlage, für die sich niemand zuständig fühlt.
Druckbare Dashboards
Drucken Sie eine Ansicht hinter einem Login nach Zeitplan, damit sich das Wochenpaket von selbst zusammenstellt.
Eine vollständige Anfrage und was sie zurückgibt
Senden Sie das HTML, oder stattdessen eine url, mit Ihrem API-Schlüssel an POST /render/v1/pdf. Ein Erfolg ist 200 mit Content-Type: application/pdf und dem Dokument als Body. Alles andere ist JSON, {"error": {"code", "message"}}, prüfen Sie also den Status, bevor Sie den Body als PDF speichern. Diese Anfrage rendert die Rechnungsvorlage aus der Anleitung:
curl -sS https://api.ironfang.com/render/v1/pdf \
-H "Authorization: Bearer $IRONFANG_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @request.json \
-o invoice.pdf \
-w '%{http_code} %{content_type}\n'200 application/pdf bedeutet, dass invoice.pdf die Rechnung ist. Laden Sie request.json herunter, die HTML-Vorlage, aus der sie erstellt wurde, oder das PDF, das dabei entsteht.
Was Sie vor der Integration wissen sollten
- Papier: A3, A4, A5, Letter, Legal und Tabloid, im Hoch- oder Querformat. Ohne Papierformat ist die Seite Letter, und das angeforderte Format hat Vorrang vor der
@page-Größe eines Stylesheets. - Ränder werden in Zoll angegeben, für jede Seite einzeln. Kopf- und Fußzeilen werden innerhalb der Ränder gezeichnet, lassen Sie also Platz dafür.
- Wenn Sie nur eine Fußzeile senden, druckt Chromium seine Standardkopfzeile mit Datum und Titel; senden Sie
"header_html": "<span></span>"mit. - Hintergründe werden weggelassen, sofern
print_backgroundnicht true ist. - Es gelten die Schriften des Renderers: Laden Sie jede andere mit
@font-facevon einer öffentlichen URL oder aus einer Data-URI. Bilder und Stylesheets müssen aus dem öffentlichen Internet erreichbar sein. - Seitenumbrüche folgen CSS:
break-inside: avoidhält eine Zeile oder einen Block zusammen, und dertheadeiner Tabelle wiederholt sich auf jeder Seite. - PDFs werden nie gecacht, und signierte URLs liefern keine PDFs aus. Bewahren Sie die Dokumente auf, die Sie ausstellen; ein Batch-Job kann sie in Ihren eigenen S3-Bucket liefern.
- Ein Rendering bricht nach 30 Sekunden ab; ein fehlgeschlagenes Rendering zählt nichts.
Sie erzeugen Rechnungen?
Ein Rechnungslauf braucht mehr als ein gerendertes Dokument: Tausende davon am Monatsersten, eine archivierte Kopie in Ihrem Besitz und einen Download-Link, den ein Kunde nutzen kann, ohne dass Ihre Anwendung die Bytes streamt. Dafür gibt es eine eigene Seite, und die Anleitung zu Rechnungs-PDFs enthält eine vollständige Rechnungsvorlage, die Anfrage, die sie rendert, und das PDF, das dabei entsteht.
Preise
Berechnet pro PDF, nicht pro Seite
Jedes PDF zählt einmal, alle Seiten bis 100 inbegriffen; ein längeres Dokument wird abgelehnt und zählt nichts. PDFs werden nie zwischengespeichert, jede Anfrage rendert also neu, und ein fehlgeschlagenes Rendering zählt nichts. Jedes Konto hat jeden Monat ein kostenloses Kontingent, ohne Karte. Darüber hinaus berechnet Pay as you go die unten stehenden Preise, innerhalb des monatlichen Nutzungslimits, das Sie festlegen. Preise ohne Umsatzsteuer.
PDFs
Jedes zurückgegebene oder gespeicherte PDF, alle Seiten innerhalb der Seitengrenze inbegriffen.
100 PDFs kostenlos pro Monat
| Berechnete Einheiten nach dem kostenlosen Kontingent | Preis je 1.000 |
|---|---|
| Die ersten 10.000 | 1,50 £ |
| Die nächsten 90.000 | 0,70 £ |
| Die nächsten 900.000 | 0,50 £ |
| Über 1.000.000 | 0,40 £ |
Preise von Ironfang Render ansehenMit anderen Anbietern vergleichen
Fragen
Bevor Sie integrieren
Die Details, die entscheiden, ob es passt, ohne vorher die ganze Referenz zu lesen.
- Kann ich HTML direkt statt einer URL senden?
- Ja, und das ist der Normalfall. Senden Sie das HTML, das Ihre Anwendung bereits rendert, und es wird unverändert gedruckt: Das Dokument, das Sie in Ihrer eigenen Anwendung sehen, ist das Dokument, das als Datei ankommt.
- Welche Papierformate werden unterstützt?
- A3, A4, A5, Letter, Legal und Tabloid, im Hoch- oder Querformat, mit Rändern in Zoll für jede Seite und einem Skalierungsfaktor, den Sie pro Anfrage festlegen.
- Kann ich auf jeder Seite eine Kopf- und Fußzeile einfügen?
- Ja. Liefern Sie HTML für Kopf- und Fußzeile, und es wiederholt sich auf jeder Seite, dort, wo Seitenzahlen, ein Logo oder eine Dokumentreferenz meist hingehören.
- Warum fehlen meine Hintergrundfarben?
- Browser drucken Hintergründe standardmäßig nicht. Schalten Sie das Drucken von Hintergründen in der Anfrage ein, und Ihre CSS-Farben, Tönungen und Flächen bleiben erhalten.
- Muss die Seite öffentlich sein?
- Nein. Eine PDF-Anfrage nimmt dieselben eigenen Header, denselben Authorization-Header und dieselben Cookies an wie ein Screenshot, sodass ein Dokument hinter einem Login genauso gedruckt wird.
- Was kostet ein PDF?
- Jedes PDF zählt einmal über den PDF-Zähler, alle Seiten bis 100 inbegriffen; ein längeres Dokument wird abgelehnt und zählt nichts. Jede PDF-Anfrage rendert das Dokument neu, ein fehlgeschlagenes Rendering zählt nichts, und bezahlte Nutzung, die das von Ihnen festgelegte monatliche Nutzungslimit überschreiten würde, wird abgelehnt, bevor sie beginnt. Das kostenlose Kontingent und die Preise stehen auf dieser Seite unter Preise.
- Kann ich einen QR-Code in das Dokument einfügen?
- Ja. Erzeugen Sie den Code mit dem QR-Endpunkt, der nie berechnet wird und vor der Rückgabe prüft, ob sich der Code scannen lässt, und platzieren Sie ihn dann als Bild in Ihrem HTML. Er wird wie jedes andere Bild als Teil des Layouts gedruckt.
Weniger betreiben. Mehr ausliefern.
Erzeugen Sie Ihr erstes Dokument
Erstellen Sie ein Konto, holen Sie sich einen Schlüssel und senden Sie Ihr vorhandenes HTML. Jedes Konto hat jeden Monat kostenlose PDFs.
100 kostenlose PDFs pro Monat, keine Karte erforderlich und keine Kosten für fehlgeschlagene Renderings.