Benannte Bereiche, die eine Seite zum Füllen markiert

Markieren Sie Rechtecke einer Seite mit Namen, wo Anschrift, Logo oder eine andere Seite hinkommt, sodass eine spätere Anfrage sie per Name füllt.

Zusammenfassung

Ein Formular wird einmal gestaltet: hier die Anschrift des Kunden, dort das Logo, da unten die Bestellnummer. Jeder dieser Plätze bekommt einen Namen. Gezeichnet wird davon nichts: Die Namen reisen im PDF mit. Später sendet, wer diese Seite in ein Dokument setzt, nur die Wörter und die Bilder, jedes unter seinem Namen, und jedes landet an seinem Platz, auch wenn die Seite verkleinert oder verschoben wird.

Technisch

Auf der obersten Ebene einer Anfrage geschrieben, unter "page_regions"

page_regions schreibt Seite für Seite eine Liste benannter Rechtecke unter das /PieceInfo der Seite, mit dem Zeitpunkt der letzten Änderung der Liste. Jeder Bereich gibt an, was ihn füllt — Wörter, ein Bild oder eine Seite eines anderen PDF —, wo er liegt, wie seine Wörter gesetzt werden oder wie ein Bild eingepasst wird, und ein Muster, das er zeigt, solange er nicht gefüllt ist. Ein pdf_page-Element, das diese Seite platziert, füllt die Bereiche über ihre Namen mit seinem fill, wo immer die Seite landet und in welcher Größe auch immer.

Anfrageschema

  • page_regions — Array, optional, standardmäßig leer.
  • page_regions[].page — Ganzzahl ≥ 1, erforderlich. Die Seite, auf der die Bereiche liegen.
  • page_regions[].modified — Zeichenkette, erforderlich. Wann die Liste zuletzt geändert wurde, Datum und Uhrzeit nach ISO 8601.
  • page_regions[].regions — Array, erforderlich. Die Bereiche, jeder unter einem Namen, den kein anderer Bereich der Seite trägt.
  • regions[].name — Zeichenkette, erforderlich. Der Name, den eine Füllung angibt.
  • regions[].kind — text, image oder page, erforderlich. Was ihn füllt: Wörter, ein Bild oder eine Zeichnung, eine Seite eines anderen PDF.
  • regions[].rect — Objekt, erforderlich. Wo er auf der Seite liegt: llx, lly, urx, ury, in Punkt.
  • regions[].font, font_size, color und align — optional. Wie die Wörter eines Textbereichs gesetzt werden: der Name einer Standardschrift oder einer Schrift, die die füllende Anfrage nennt, die Größe in Punkt, eine Gerätefarbe und left, right, center oder justify.
  • regions[].next — Zeichenkette, optional. Der Textbereich, in den die Wörter weiterlaufen, die in diesen nicht passen.
  • regions[].fit und anchor — optional. Wie ein Bild oder eine Seite an den Bereich angepasst wird und wo es darin liegt.
  • regions[].sample — Zeichenkette, optional. Was der Bereich zeigt, solange er nicht gefüllt ist: seinen Text oder den Namen der Datei, die ihn füllen soll.
  • regions[].custom — Array, optional, standardmäßig leer. Benannte Werte, die der Bereich für das Programm trägt, das ihn füllt, jeder ein name und ein value, geschrieben wie das data eines Dokumentteils sie schreibt. Nichts davon wird gezeichnet.

Abgelehnt, 400: zwei Bereiche einer Seite unter einem Namen, ein leerer Name, ein Rechteck ohne Breite oder Höhe, Wörter, die an einen Bereich weitergeleitet werden, den die Seite nicht markiert, und ein Zeitpunkt, der kein Datum mit Uhrzeit ist.

Eine vollständige Anfrage, die ein PDF erzeugt

{
  "page_regions": [
    {
      "page": 1,
      "modified": "2026-10-07T09:00:00Z",
      "regions": [
        {
          "name": "recipient",
          "kind": "text",
          "rect": { "llx": 72, "lly": 600, "urx": 300, "ury": 680 },
          "font": "Helvetica",
          "font_size": 10,
          "sample": "Recipient's name",
          "custom": [{ "name": "column", "value": { "text": "customer_address" } }]
        },
        {
          "name": "logo",
          "kind": "image",
          "rect": { "llx": 400, "lly": 700, "urx": 520, "ury": 770 },
          "fit": "contain",
          "anchor": "top_right",
          "sample": "logo.png"
        }
      ]
    }
  ],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 740, "urx": 380, "ury": 770 },
      "content": ["Delivery label"],
      "font": "sans",
      "font_size": 14
    }
  ]
}

Die Zeile, die es sendet, in drei Sprachen

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 Die Vorlage unter den Seiten Ein über eine Reihe von Seiten gelegtes Wasserzeichen

Wohin als Nächstes

Jeder JSON-Schlüssel einer Anfrage, auf einer Seite Die übrigen einundvierzig Einstellungen einer Anfrage

Die Preise ansehen Die Beispiele ansehen