Ein mitgesendetes PDF als Seiten des Dokuments
Beginnen Sie das Dokument mit den Seiten eines mitgesendeten PDF, jede in ihrer eigenen Größe, und schreiben Sie darüber.
Zusammenfassung
Sie senden ein PDF mit der Anfrage und geben es als Quelle an: Seine Seiten werden zu den Seiten des Dokuments, jede in ihrer eigenen Größe, in der Reihenfolge, die Sie wählen – alle, nur einige oder eine Seite mehrmals. Was die Anfrage zeichnet, wird darüber geschrieben, und jede andere Einstellung gilt für sie wie für jede Seite: Wird der Text als Formen gezeichnet, kommt ein so gesendetes PDF ohne kopierbaren Text zurück.
Technisch
Auf der obersten Ebene einer Anfrage geschrieben, unter
"source"
source nennt den Teil der Anfrage, der ein PDF enthält, und die daraus übernommenen Seiten, ab eins gezählt, in der Reihenfolge, in der das Dokument sie enthält. Jede übernommene Seite wird zu einer Seite des Dokuments in der Größe ihres Blatts; Seite eins ist die erste übernommene. Sie wird vollständig platziert, so wie ein pdf_page-Element sie platzieren würde, das ihr Blatt über die ganze Seite legt, und zwar vor jedem Element, sodass die Elemente darüber zeichnen. Gibt page_sizes für eine dieser Seiten eine Größe an, gilt diese Größe, und die Seite wird darauf skaliert. Alles außer dem Seiteninhalt – die Metadaten der Datei, ihre Lesezeichen, Verweise, Formularfelder und ihr Strukturbaum – wird nicht übernommen. Wie weit sich ein Stream dieses PDF entpacken darf, bestimmt die Obergrenze, die supplied_pdfs setzt.
Anfrageschema
-
source— Objekt, optional, standardmäßig nicht gesetzt. -
source.pdf— Zeichenkette, erforderlich. Der Name des Teils, der das PDF enthält. -
source.pages— Array von Ganzzahlen ab eins, optional, standardmäßig leer. Die übernommenen Seiten in der Reihenfolge, in der das Dokument sie enthält; eine zweimal genannte Seite wird zweimal übernommen. Ist es leer oder fehlt es, werden alle Seiten in ihrer Reihenfolge übernommen. - Mit dem Status 400 abgelehnt: ein Name, für den kein Teil geliefert wurde, und eine Seite nach der letzten Seite des gelieferten PDF.
Eine vollständige Anfrage, die ein PDF erzeugt
Ein Name unten steht für eine Schriftdatei: Setzen Sie die kodierte Datei an seine Stelle oder senden Sie die Datei selbst neben der Beschreibung, als mitgelieferten Teil desselben Aufrufs. Eine Seite trägt eine echte, bereits kodierte Schrift, und ihre Anfrage wird unverändert gesendet.
{
"source": { "pdf": "letterhead", "pages": [1] },
"text_as_shapes": true,
"fonts": [{ "name": "body", "data": "PASTE_THE_FONT_FILE_BASE64_HERE" }],
"items": [
{
"type": "text",
"rect": { "llx": 60, "lly": 60, "urx": 535, "ury": 82 },
"content": ["Received on 22 October 2026"],
"font": "body",
"font_size": 14
}
]
}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 Wie weit sich ein mitgeliefertes PDF entpacken darf Die Vorlage unter den Seiten 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