Quels fichiers emportés une page réclame

En mots de tous les jours

Écrit pour tout le monde. Il dit ce que cela pose sur une feuille de papier, et ne vous demande rien de plus.

Un PDF qui emporte un seul fichier, c'est simple : le fichier appartient au document. Mais envoyez leur relevé à cent clients dans un seul PDF, chacun avec le fichier de données qui va avec, et « le document » n'est plus la bonne réponse — le fichier numéro sept appartient à la page sept et à aucune autre. C'est ici qu'on le dit. Celui qui recoupe le gros document en cent petits sait alors quel fichier suit quelle page, sans avoir à le deviner d'après un nom.

Pour un développeur

Écrit pour celui qui écrit le programme appelant : le modèle, les unités, et les réglages qui portent le poids.

Écrit au premier niveau d'une requête, sous "page_files"

page_files dit lesquels des fichiers déclarés dans attachments chaque page réclame. Chaque entrée nomme la page qu'elle vise, comptée à partir de 1, et les noms des fichiers que cette page réclame. Une page nommée deux fois réclame les fichiers de la dernière entrée donnée pour elle, en entier plutôt qu'en les additionnant. Un fichier qu'aucune page ne réclame reste emporté par le document lui-même, ce qui est la forme d'un PDF ne portant qu'une seule facture.

Chaque clé, avec son défaut

La référence : quelles clés sont obligatoires, lesquelles sont facultatives, ce que vaut chacune par défaut et quelles combinaisons le serveur décline.

• page_files — tableau, facultatif, vide par défaut.
• page_files[].page — entier, obligatoire, à partir de 1, comme tout numéro de page dans une demande.
• page_files[].files — tableau de chaînes, obligatoire. Les noms des fichiers déclarés que la page réclame. Chacun doit nommer une entrée d'attachments.

Portée : les pages nommées. Une page nommée deux fois prend la dernière entrée donnée pour elle, en entier : les deux listes ne s'additionnent pas.

Une requête entière qui le dessine

Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.

{
  "attachments": [
    {
      "name": "first_sitting",
      "file_name": "sitting-1911-03-14.xml",
      "description": "The sitting as a data file",
      "media_type": "text/xml",
      "relationship": "data",
      "modified": "2026-08-03T09:15:00+02:00"
    }
  ],
  "page_files": [{ "page": 1, "files": ["first_sitting"] }],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
      "content": ["The sitting this page claims a file for"],
      "font": "sans",
      "font_size": 12
    }
  ]
}

La ligne qui l'envoie, en trois langages