Un PDF que vous envoyez, pris comme pages du document
Ouvrir le document sur les pages d’un PDF que vous envoyez, chacune à sa taille, et écrire par-dessus.
Résumé
Vous envoyez un PDF avec la requête et le désignez comme source : ses pages deviennent les pages du document, chacune à sa taille, dans l’ordre que vous choisissez — toutes, seulement certaines, ou une même page plusieurs fois. Ce que la requête dessine s’écrit par-dessus, et tous les autres réglages s’y appliquent comme à n’importe quelle page : si chaque lettre devient une forme tracée, un PDF envoyé ainsi vous revient sans plus aucun texte à copier.
Techniquement
Écrit au premier niveau d’une requête, sous
"source"
source nomme la partie du corps qui contient un PDF, et les pages, numérotées à partir de 1, qui en sont reprises, dans l’ordre où le document les contient. Chaque page reprise devient une page du document à la taille de sa feuille, la page 1 étant la première reprise. Elle est placée entière, comme la placerait un élément pdf_page posant sa feuille sur toute la page, avant tout élément, si bien que les éléments se dessinent par-dessus. Si page_sizes déclare une taille pour l’une de ces pages, c’est cette taille qui est écrite, et la page est mise à l’échelle pour s’y adapter. Ce qui n’est pas du dessin — les métadonnées du fichier, ses signets, ses liens, ses champs de formulaire et son arbre de structure — n’est pas repris. Le plafond de décompression de chacun de ses flux est celui que fixe supplied_pdfs.
Schéma de la requête
-
source— objet, facultatif, absent par défaut. -
source.pdf— chaîne, obligatoire. Le nom de la partie qui contient le PDF. -
source.pages— tableau d’entiers numérotés à partir de 1, facultatif, vide par défaut. Les pages reprises, dans l’ordre où le document les contient ; une page nommée deux fois est reprise deux fois. S’il est vide ou absent, toutes les pages sont reprises, dans leur ordre. - Refusés avec un statut 400 : un nom pour lequel aucune partie n’a été fournie, et une page au-delà de la dernière page du PDF fourni.
Une requête entière qui crée un PDF
Un nom ci-dessous tient lieu de fichier de police : mettez le fichier encodé à sa place, ou envoyez le fichier lui-même à côté de la description, comme une pièce fournie dans le même appel. Une page contient une vraie police déjà encodée, et sa requête part telle quelle.
{
"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
}
]
}La feuille, et ce qu’on pose dessous
La taille des pages Une taille propre à certaines pages L’unité dans laquelle une page est mesurée Où se place la feuille d’une page dans le dessin Les zones que la page déclare Les formes posées sur ce qu’une page dessine Dans quel sens une page s’affiche Comment une page arrive, et combien de temps elle reste Jusqu’où un PDF fourni a le droit de se déplier Le modèle sous les pages Un filigrane posé sur une suite de pages Zones nommées à remplir sur une page
Où aller ensuite
Toutes les clés JSON d’une requête, en une page Les quarante et un autres réglages d’une requête