Les pièces jointes du document, à côté de ses pages

Joignez des fichiers entiers au PDF — la donnée dont une facture a été tirée, le même relevé sous une autre forme — chacun nommé, décrit et daté.

Résumé

Un PDF peut contenir des fichiers, comme une enveloppe contient une lettre et un formulaire. Qui ouvre le document voit la liste de ce qu'il contient et peut en enregistrer n'importe lequel. C'est ce qui fait marcher une facture électronique : les pages sont la facture que lit une personne, et le fichier contenu à l'intérieur est la même facture sous une forme que lit un programme, si bien que les deux ne peuvent jamais dire des choses différentes. Ce qui compte le plus sur chaque pièce jointe, c'est ce qu'elle est pour le document : le fichier dont le document est issu, la même chose dite autrement, ou quelque chose qu'on y a ajouté.

Techniquement

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

attachments écrit les fichiers que le document contient à côté de ses pages dans l'arbre de noms /EmbeddedFiles et les associe au document par /AF, chacun sous le nom que la requête lui donne, dans l'ordre où ils sont rangés. Les octets eux-mêmes arrivent à côté de la requête, dans une partie qui a ce nom. relationship est l'/AFRelationship du fichier ; elle n'a pas de valeur par défaut et elle est obligatoire : personne d'autre que l'expéditeur ne sait si le fichier est la source dont le document est issu, une variante qui dit la même chose sous une autre forme, les données qui le sous-tendent, ou un complément. modified est la /ModDate des /Params du fichier : la date à laquelle les données du fichier ont été touchées pour la dernière fois, non la date de création du PDF. Une page réclame par page_files les fichiers qui lui appartiennent, et un document d'archivage les contient selon les règles que fixe sa norme.

Schéma de la requête

  • attachments — tableau, facultatif, vide par défaut.
  • attachments[].name — chaîne, obligatoire. Le nom de la partie fournie qui contient le fichier, et aussi le nom sous lequel le reste de la requête le réclame.
  • attachments[].file_name — chaîne, obligatoire. Le nom sous lequel le fichier est joint, et le nom que le 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 contient.
  • 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, horodatage ISO 8601. La date à laquelle les données du fichier ont changé pour la dernière fois, non la date de création du PDF.

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 contenu par le document lui-même.

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

{
  "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 montre le logiciel de lecture Cent courriers dans un seul fichier Ce que le document dit de lui-même Les notes qu'un programme laisse pour lui-même Les notes qu'un programme laisse sur une page Un fichier encore lisible dans des dizaines d'années La norme d'impression que le document revendique Le mot de passe qui l'ouvre, et ce qu'on peut en faire 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, et comment elle est lue Les fichiers contenus, présentés en portefeuille Les pièces jointes d'une page La fiche d'identité que contient une seule page La norme d'accessibilité que le document déclare Les normes contre lesquelles le document fini est mesuré

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