La fiche d'identité que porte une seule page

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 document a une fiche d'identité : un titre, un auteur, un sujet, une date. Quand un seul PDF porte cent choses séparées — un registre de séances, une suite de relevés — une seule fiche pour l'ensemble ne suffit plus. Chaque page peut porter la sienne. Recoupez le document en morceaux et chaque morceau dit encore qui l'a écrit, quand, et à quel sujet. C'est la même information que la fiche du document, écrite pour une page au lieu de toutes.

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

page_metadata donne à une page un paquet à elle, dans la même forme que celui du document. Deux écritures sont acceptées : facts, les champs écrits un par un — titre, auteur, sujet, mots-clés, dates — dont le paquet est fabriqué ; ou packet, un paquet déjà écrit, repris tel quel. Une page nommée deux fois porte le dernier paquet donné pour elle. Le paquet du document ne bouge pas : ceci ajoute une fiche à une page, ça ne remplace pas celle de la couverture.

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_metadata — tableau, facultatif, vide par défaut.
• page_metadata[].page — entier, obligatoire, à partir de 1, comme tout numéro de page dans une demande.
• page_metadata[].metadata — objet, obligatoire. Soit facts, un objet portant les champs de la fiche du document (title, author, subject, keywords, created, modified), soit packet, un paquet déjà écrit et repris tel quel.

Portée : les pages nommées. Une page nommée deux fois porte le dernier paquet donné pour elle. metadata règle la fiche du document et n'est pas touchée par ceci.

Une requête entière qui le dessine

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

{
  "page_metadata": [
    {
      "page": 1,
      "metadata": {
        "facts": {
          "title": "First sitting",
          "author": "R. Delaunay, clerk",
          "subject": "One sitting of the register",
          "created": "1911-03-14T09:00:00+01:00"
        }
      }
    }
  ],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 700, "urx": 523, "ury": 740 },
      "content": ["A page carrying an identity card of its own"],
      "font": "sans",
      "font_size": 12
    }
  ]
}

La ligne qui l'envoie, en trois langages