Zones nommées à remplir sur une page

Délimitez sur une page des rectangles nommés : adresse, logo ou autre page, qu’une requête remplira ensuite, chacun par son nom.

Résumé

Un formulaire se met en page une seule fois : ici l’adresse du client, là le logo, en bas le numéro de commande. Chacun de ces emplacements reçoit un nom. Les emplacements restent invisibles : seuls leurs noms voyagent dans le PDF. Plus tard, celui qui place cette page dans un document n’envoie que les textes et les images, chacun sous son nom, et chacun prend sa place, même quand la page est réduite ou déplacée.

Techniquement

Écrit au premier niveau d’une requête, sous "page_regions"

page_regions inscrit, page par page, une liste de rectangles nommés dans le /PieceInfo de la page, avec la date et l’heure de sa dernière modification. Chaque zone indique ce qui la remplit (du texte, une image ou une page d’un autre PDF), sa position, la composition de son texte ou l’ajustement de son image, et l’exemple qu’elle affiche tant qu’elle reste vide. Un élément pdf_page qui place cette page remplit les zones par leur nom au moyen de sa clé fill, quels que soient l’emplacement et la taille de la page.

Schéma de la requête

page_regions — tableau, facultatif, vide par défaut.
page_regions[].page — entier ≥ 1, obligatoire. La page où se trouvent les zones.
page_regions[].modified — chaîne, obligatoire. La date et l’heure de la dernière modification de la liste, au format ISO 8601.
page_regions[].regions — tableau, obligatoire. Les zones, chacune sous un nom qu’aucune autre zone de la même page ne porte.
regions[].name — chaîne, obligatoire. Le nom sous lequel un remplissage désigne la zone.
regions[].kind — text, image ou page, obligatoire. Ce qui remplit la zone : du texte, une image ou un dessin, une page d’un autre PDF.
regions[].rect — objet, obligatoire. La position de la zone sur la page : llx, lly, urx, ury, en points.
regions[].font, font_size, color et align — facultatifs. La composition du texte d’une zone de texte : le nom d’une police standard ou d’une police que nomme la requête de remplissage, la taille en points, une couleur d’appareil, et l’alignement, left, right, center ou justify.
regions[].next — chaîne, facultative. La zone de texte où se poursuit le texte qui ne tient pas dans celle-ci.
regions[].fit et anchor — facultatifs. La façon dont une image ou une page est dimensionnée dans la zone, et sa position à l’intérieur.
regions[].sample — chaîne, facultative. Ce que la zone affiche tant qu’elle reste vide : son texte, ou le nom du fichier destiné à la remplir.
regions[].custom — tableau, facultatif, vide par défaut. Les valeurs nommées que la zone contient, destinées au programme qui la remplit, chacune formée d’un name et d’une value écrits comme dans le data d’une partie de document. Aucune n’apparaît sur la page.

Refusé, 400 : deux zones d’une même page sous le même nom, un nom vide, un rectangle sans largeur ou sans hauteur, du texte renvoyé vers une zone que la page ne délimite pas, ou une valeur de modified qui n’est pas une date et une heure.

Une requête entière qui crée un PDF

{
  "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
    }
  ]
}

La ligne qui l’envoie, en trois langages

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 Un PDF que vous envoyez, pris comme pages du document 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

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

Voir les prix Voir les exemples