Die Vorlage unter den Seiten
Legen Sie die Seiten des Dokuments über ein bereits erzeugtes PDF: einen Briefkopf, einen Vertragshintergrund, ein Unterschriftsblatt.
In einem echten PDF ansehen
Eine Tabelle, die sich selbst umbricht
Eine lange, als Ganzes übergebene Tabelle, die selbst entscheidet, wo die Seiten umbrechen: ihre Überschrift oben auf jeder Seite, ihre Fußnote unter jeder Seite, die Zelle eines Quartals über ihre Zeilen gespannt und oben auf der nächsten Seite erneut geschrieben, wenn eine Seite sie teilt, und eine Notiz, die Sie unter jede Seite genau an die Stelle zeichnen, die die Tabelle meldet.
Das PDF öffnen Das vollständige Beispiel ansehen
Auch zu sehen in: Ein Vertrag auf drei mitgelieferten Vorlagen
Zusammenfassung
Viele Firmen haben einen Briefkopf: das Logo oben, die Anschrift unten und eine breite Fläche dazwischen zum Beschreiben. Dasselbe gibt es hier in digitaler Form, und Sie können sogar drei davon liefern: einen für die erste Seite, einen für die Seiten dazwischen, einen für die letzte — etwa das Unterschriftsblatt.
Technisch
Auf der obersten Ebene einer Anfrage geschrieben, unter
"templates"
templates nennt bis zu drei Vorlagen-PDF, die nach Seitenposition unter die Seiten gestempelt werden: Anfang, Mitte, Ende. Die Bytes jeder Vorlage kommen neben der Anfrage an, in einem Formularteil mit genau diesem Namen, aus demselben Bestand, aus dem die platzierten Seiten stammen. Die mittlere Vorlage enthält eine einzige Seite, so oft wiederholt wie nötig; Anfangs- und Endvorlage dürfen mehrere umfassen. Alle drei Schlüssel sind optional: Eine Anfrage kann auch nur einen angeben.
Anfrageschema
-
templates— Objekt, optional, standardmäßig nicht gesetzt. -
templates.start— Zeichenkette, optional. Der Name des mitgelieferten Teils mit der Vorlage, die unter die ersten Seiten des Dokuments gelegt wird. -
templates.middle— Zeichenkette, optional. Der Name des mitgelieferten Teils mit der einseitigen Vorlage, die unter die Seiten zwischen der ersten und der letzten gelegt wird. Eine mehrseitige Vorlage wird hier abgelehnt. -
templates.end— Zeichenkette, optional. Der Name des mitgelieferten Teils mit der Vorlage, die unter die letzten Seiten des Dokuments gelegt wird. -
templates.fields— Objekt, optional, standardmäßig nicht gesetzt. Ob die Formularfelder einer Vorlagenseite auf jeder Seite, die sie hinterlegt, erneut angelegt werden, dort, wo sie sie zeigt:font, erforderlich, der Name der Schrift, in der ein mitgebrachtes Textfeld, eine Auswahl oder eine Schaltfläche gesetzt wird;font_size, erforderlich, die Größe in Punkt, in der sie gesetzt werden. Fehlt es, bringt eine Vorlage nur ihre Zeichnung mit.
Jeder Name verweist auf einen Teil des multipart/form-data-Bodys, neben json_data. Ein Name, den kein Teil trägt, wird abgelehnt. Eine Seite mitten auf der Seite aus einem anderen Dokument zu übernehmen ist ein pdf_page-Element, das aus demselben Bestand mitgelieferter Teile schöpft.
Eine Vorlage wird einmal in das Dokument geschrieben, wie viele Seiten sie auch tragen: Jede dieser Seiten verweist auf dieselbe Form. Sie unter hundert Seiten zu legen kopiert ihre Bytes nicht hundertmal.
Inhalt, der nicht passt, läuft von selbst auf der nächsten Seite weiter, wie es eine Tabelle und ein Fließtext bereits tun, und die mittlere Vorlage wird unter jede der Seiten gelegt, die er braucht.
Eine aus einem anderen Dokument übernommene Seite, die mehr als zehntausend Wörter zeigt, wird einer Anfrage ohne Lizenzschlüssel verweigert. Unterhalb dieser Zahl wird die Seite unverändert übernommen, mitsamt Text; darüber nicht. Diese Grenze ist unsere, keine Regel des Formats.
Eine vollständige Anfrage, die ein PDF erzeugt
{
"templates": { "start": "letterhead" },
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "text",
"rect": { "llx": 60, "lly": 640, "urx": 535, "ury": 700 },
"content": ["Dear Madam,\nThank you for your order of 4 August."],
"font": "sans",
"font_size": 11,
"leading": 15
}
]
}Das Blatt und was darunter gelegt wird
Die Größe der Seiten Ein eigenes Format für bestimmte Seiten Die Einheit, in der eine Seite gemessen wird Wo das Blatt einer Seite in der Zeichnung sitzt Die Bereiche, die eine Seite angibt Die Formen, die eine Seite über das Gezeichnete legt Wie herum eine Seite gezeigt wird Wie eine Seite erscheint und wie lange sie stehen bleibt Ein mitgesendetes PDF als Seiten des Dokuments Wie weit sich ein mitgeliefertes PDF entpacken darf Ein über eine Reihe von Seiten gelegtes Wasserzeichen Benannte Bereiche, die eine Seite zum Füllen markiert
Wohin als Nächstes
Jeder JSON-Schlüssel einer Anfrage, auf einer Seite Die übrigen einundvierzig Einstellungen einer Anfrage