Le modèle sous les pages
Poser les pages du document sur un PDF déjà fait : un papier à en-tête, un fond de contrat, une feuille de signature.
Résumé
Beaucoup d'entreprises ont du papier à en-tête : le logo en haut, l'adresse en bas, et un grand blanc au milieu pour écrire. Ici c'est la même chose, en numérique, et vous pouvez même en fournir trois : un pour la première page, un pour les pages du milieu, un pour la dernière — la page de signature, par exemple.
Techniquement
Écrit au premier niveau d'une requête, sous
"templates"
templates nomme jusqu'à trois PDF de modèle apposés sous les pages, selon la position de la page : le début, le milieu, la fin. Les octets de chaque modèle arrivent à côté de la requête, dans une partie de formulaire qui a exactement ce nom, prise dans le même vivier que les pages placées. Le modèle du milieu ne comprend qu'une seule page, répétée autant de fois qu'il le faut ; ceux du début et de la fin peuvent en compter plusieurs. Les trois clés sont facultatives : une requête peut n'en donner qu'une.
Schéma de la requête
-
templates— objet, facultatif, absent par défaut. -
templates.start— chaîne, facultatif. Le nom de la partie fournie qui contient le modèle posé sous les premières pages du document. -
templates.middle— chaîne, facultatif. Le nom de la partie fournie qui contient le modèle d'une seule page posé sous les pages entre la première et la dernière. Un modèle de plusieurs pages est refusé ici. -
templates.end— chaîne, facultatif. Le nom de la partie fournie qui contient le modèle posé sous les dernières pages du document.
Chaque nom désigne une partie du corps multipart/form-data, à côté de json_data. Un nom qui ne correspond à aucune partie est refusé. Une page importée d'un autre document en cours de page se fait par un élément pdf_page, qui puise dans le même vivier de parties fournies.
Un modèle n'est écrit qu'une fois dans le document, quel que soit le nombre de pages qui le reçoivent : chacune de ces pages renvoie à la même forme. En poser un sous cent pages ne copie pas ses octets cent fois.
Le contenu qui ne tient pas continue tout seul sur la page suivante, comme le font déjà un tableau et un texte au fil, et le modèle du milieu est posé sous chacune des pages qu'il occupe.
Une page reprise d'un autre document qui montre plus de dix mille mots est refusée à une demande sans clé de licence. Sous ce compte, la page entre telle quelle, texte compris ; au-dessus, elle n'entre pas. Cette limite est la nôtre, pas une règle du format.
Une requête entière qui crée un PDF
{
"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
}
]
}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 Les zones que la page déclare Les formes posées sur ce qu'une page dessine L'orientation à l'écran et à l'impression Comment une page arrive, et combien de temps elle reste Jusqu'où un PDF fourni a le droit de se déplier
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