write_overlay.json
Le fichier JSON de l'exemple « Une facture posée sur un modèle à en-tête ». Une facture posée sur un papier à en-tête fourni sous forme de fichier PDF.
Ce fichier est une requête : une application l'envoie par le réseau au serveur, qui crée le PDF et le renvoie. Il donne la même page que les versions Rust et Python de cet exemple. Une requête nomme chaque fichier qu'elle emploie, jamais le contenu de ces fichiers ; l'appel porte la requête et les fichiers ensemble. Une police que le serveur détient déjà, comme DejaVuSans, se nomme sans rien y joindre. Envoyez la requête à l'adresse que donne la page de l'API.
Cette requête nomme des fichiers qu'elle ne contient pas : letterhead. Chacun voyage à côté de la requête, dans le même appel, comme une pièce fournie nommée exactement comme la requête la nomme ici — la description dit quel nom joue quel rôle, vous nommez donc vos fichiers comme vous voulez. Une requête qui nomme un fichier dont l'appel ne contient rien est refusée.
À quoi sert cet exemple
Chaque client a son propre papier à en-tête, et pas un ne vous enverra les polices, le fichier du logo et la couleur exacte à l'impression. Ce qu'il vous enverra, c'est un PDF. Refaire cet en-tête à la main, c'est le sortir à peu près juste — sur chacun des documents que vous produirez pour lui, aussi longtemps qu'il restera client.
Ce que montre cet exemple
- Un modèle lu une fois et réemployé tel quel.
- Ses polices et ses couleurs reportées intactes.
- Du contenu neuf composé par-dessus la page qu'il pose.