Des fichiers que le document emporte à côté de ses pages

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 peut emporter des fichiers à l'intérieur, comme une enveloppe emporte une lettre et un formulaire. Celui qui ouvre le document voit la liste de ce qu'il emporte et peut enregistrer ce qu'il veut. C'est ce qui fait marcher une facture électronique : les pages sont la facture qu'une personne lit, et le fichier emporté à l'intérieur est la même facture sous une forme qu'un programme lit, de sorte que les deux ne peuvent jamais dire des choses différentes. Chaque fichier emporté reçoit le nom sous lequel il sera enregistré, une phrase disant ce qu'il est pour la personne qui lit la liste, la sorte de fichier dont il s'agit, la date où son contenu a bougé pour la dernière fois, et — celui qui compte — ce qu'il est pour le document : le fichier dont le document a été tiré, la même chose dite autrement, ou quelque chose qu'on y ajoute.

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 "attachments"

attachments déclare les fichiers que le document emporte à côté de ses pages, chacun sous le nom par lequel la demande le réclame, dans l'ordre où ils sont emportés. Les octets eux-mêmes arrivent avec la demande, en morceau portant ce nom. relationship n'a pas de valeur par défaut et reste obligatoire : personne d'autre que l'expéditeur ne sait si le fichier est la source dont le document a été tiré, une autre forme qui dit la même chose, la donnée qui est derrière, ou un ajout. modified est la date où la donnée du fichier a bougé pour la dernière fois, pas celle où le PDF a été fabriqué. Une page réclame les fichiers qui lui reviennent par page_files, et un document d'archivage les emporte sous les règles que sa norme pose.

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.

attachments — tableau, facultatif, vide par défaut.
attachments[].name — chaîne, obligatoire. Le nom du morceau fourni qui porte le fichier, qui est aussi celui sous lequel le reste de la demande le réclame.
attachments[].file_name — chaîne, obligatoire. Le nom sous lequel le fichier est attaché, et celui qu'un logiciel de lecture propose pour l'enregistrer.
attachments[].description — chaîne, obligatoire. Ce qu'est le fichier, en mots, pour la personne qui lit la liste de ce que le document emporte.
attachments[].media_type — chaîne, obligatoire. Le type de contenu du fichier : text/xml pour un document XML.
attachments[].relationship — chaîne, obligatoire, sans valeur par défaut. L'une de source, alternative, data, supplement, unspecified.
attachments[].modified — chaîne, obligatoire, un horodatage ISO 8601. La date où la donnée du fichier a changé pour la dernière fois, et non celle où le PDF a été fabriqué.

Portée : le document entier. page_files dit quelles pages réclament lesquels de ces fichiers ; un fichier qu'aucune page ne réclame est emporté par le document lui-même.

Une requête entière qui le dessine

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

{
  "attachments": [
    {
      "name": "statement_4711",
      "file_name": "statement-4711.xml",
      "description": "The statement as a data file",
      "media_type": "text/xml",
      "relationship": "data",
      "modified": "2026-08-03T09:15:00+02:00"
    }
  ],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
      "content": ["A page, and a data file carried beside it"],
      "font": "sans",
      "font_size": 12
    }
  ]
}

La ligne qui l'envoie, en trois langages

Le document dans son ensemble

Les numéros que le logiciel de lecture affiche Cent courriers dans un seul fichier Ce que le document dit de lui-même Un fichier lisible dans trente ans Une facture qu'un humain et une machine lisent L'adresse contre laquelle les liens se lisent La version de PDF que le fichier déclare Ce qu'une image dit d'elle-même Quels fichiers emportés une page réclame La fiche d'identité que porte une seule page La norme d'accessibilité que le document déclare

Où aller ensuite

Chaque clé d'une requête, en une page Les trente-deux autres réglages d'une requête

Voir les prix Voir les exemples

Glossaire

logiciel de lecture: Le programme qui ouvre un PDF et le pose sur un écran — celui installé sur la machine, ou celui que porte un navigateur. Sur ce site, la personne qui tient le document est le lecteur, et le programme qui le lui montre est un logiciel de lecture : le document demande, et chaque programme répond pour lui-même. Sa page les nomme un par un.
octet: L'unité dans laquelle se compte le poids d'un fichier, comme un colis se compte en grammes. Mille octets font un kilo-octet, un million font un méga-octet — la taille d'une photo prise avec un téléphone. Un PDF d'une page pèse ici entre six mille et cent vingt mille, donc cent PDF tiennent dans la place de cinq photos.
norme: Une règle débattue en commission, publiée sous un numéro que n'importe qui peut acheter et lire, et identique pour toutes les entreprises qui s'en réclament. Dire qu'on la suit peut donc être vérifié face au texte. Une façon de faire qui s'est simplement répandue parce qu'elle marchait est une habitude du métier : utile, très suivie, et qui ne répond devant aucun texte.
Factur-X: Une facture qui sert deux lectures à la fois. Pour la personne qui la reçoit, c'est une page ordinaire. Pour son logiciel de comptabilité, ce sont les mêmes montants rangés à l'intérieur du même fichier, sous une forme qu'il lit tout seul : plus rien à retaper. La loi française l'impose entre entreprises.

Tous les mots que le site explique