Un code PDF417, qui contient tout un formulaire

Dessiner un code PDF417 en barres empilées, celui des cartes d’embarquement : il contient un formulaire entier, pas seulement un numéro.

Le résultat dans un vrai PDF

Codes PDF417

Le code des pièces d’identité et des papiers d’expédition : il contient bien plus de texte qu’une rangée de barres, et il survit à un scanner laser qu’on traîne dessus.

Ouvrir le PDF Voir l’exemple complet

Résumé

Un nom, une date, un numéro de vol, le tout dans un seul code : voilà à quoi servent ces rangées de barres empilées. Vous donnez le texte, le cadre, et si vous le souhaitez le nombre de colonnes, qui décide de la forme du rectangle. Vous réglez aussi la solidité : plus vous en demandez, plus le code résiste à un pli ou à une tache, et plus il occupe de place.

Techniquement

Demandé avec "type": "pdf417"

Les rangées empilées sont dessinées en rectangles pleins, et le symbole avec la zone de silence de part et d’autre remplit la largeur du rectangle, ancré au coin inférieur gauche. La hauteur obtenue découle de la largeur : un module est dessiné trois fois plus haut que large. Le nombre de colonnes de données va de 1 à 30 ; s’il est omis, l’encodeur choisit une forme environ deux fois plus large que haute. Le niveau de correction va de 0 à 8, chaque niveau coûtant deux fois ce que coûte le précédent ; s’il est omis, il prend le niveau que la norme demande pour cette longueur de texte.

Schéma de la requête

Clés obligatoires : content, une chaîne ; rect. Facultatives : columns, un entier de 1 à 30 (par défaut : le choix de l’encodeur, environ deux fois plus large que haut) ; level, un entier de 0 à 8 (par défaut : le niveau que la norme demande à cette longueur) ; pages, un tableau d’entiers comptés à partir de 1, vide par défaut ; transform, six nombres ; rotate, degrés dans le sens inverse des aiguilles d’une montre autour du centre du rectangle ; layer, le nom d’un calque déclaré. Refus croisé : transform avec rotate. Un texte plus long que le plus grand symbole, ou que ce que la forme demandée transporte, répond 400. charset, dont la seule valeur est utf_8, déclare en tête des octets qu’ils sont écrits en UTF-8, pour qu’un scanner rende un accent ou le signe euro tels qu’ils sont entrés ; absent, rien n’est déclaré. Un symbole qui le déclare donne son level et laisse les colonnes à l’encodeur : un level absent, ou columns à côté, répond 400.

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

{
  "items": [
    {
      "type": "pdf417",
      "content": "HQF/2026-08-08/PARIS/14B",
      "rect": {"llx": 72, "lly": 660, "urx": 283, "ury": 720}
    }
  ]
}

La ligne qui l’envoie, en trois langages

Les codes-barres et les codes carrés

Un code-barres à barres verticales Un QR code, de forme carrée, lisible au téléphone Un code Aztec, sans marge blanche autour Un code DataMatrix, très petit et très robuste

Où aller ensuite

Toutes les clés JSON d’une requête, en une page Les vingt-deux autres choses que l’on peut dessiner

Voir les prix Voir les exemples