Un code PDF417, qui porte tout un formulaire
Dessiner un code PDF417 en barres empilées, celui des cartes d'embarquement : il porte un formulaire entier, pas seulement un numéro.
Demandé avec
"type": "pdf417"
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.
C'est le rectangle de barres empilées en plusieurs rangées, celui des cartes d'embarquement et de certains documents officiels. Sa force est de porter tout un formulaire : un nom, une date, un numéro de vol, le tout dans un seul code. 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.
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.
Le symbole et la zone de silence de part et d'autre remplissent la largeur du rectangle, ancrés 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 ; laissé de côté, 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 ; laissé de côté, il prend le niveau que la norme demande pour cette longueur de texte.
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.
Clés obligatoires : content, chaîne ; rect. Facultatives : columns, entier de 1 à 30 (défaut : le choix de l'encodeur, environ deux fois plus large que haut) ; level, entier de 0 à 8 (défaut : le niveau que la norme demande à cette longueur) ; pages, tableau d'entiers en base 1, défaut vide ; transform, six nombres ; rotate, degrés dans le sens trigonométrique autour du centre de la boîte ; layer, nom d'un calque déclaré. Refus croisé : transform et rotate ensemble. Un texte plus long que ce que le plus grand symbole, ou que la forme demandée, sait porter reçoit une réponse 400.
Une requête entière qui le dessine
Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.
{
"items": [
{
"type": "pdf417",
"content": "HQF/2026-08-08/PARIS/14B",
"rect": {"llx": 72, "lly": 660, "urx": 283, "ury": 720}
}
]
}Les codes-barres et les codes carrés
Un code-barres à barres verticales Un code QR carré, lisible au téléphone Un code Aztec, sans marge blanche autour Un code Data Matrix, très petit et très solide
Où aller ensuite
Chaque clé d'une requête, en une page Les vingt autres choses que l'on peut dessiner
Glossaire
- 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.
- calque
- Un groupe nommé de choses dessinées sur une page, que le lecteur peut afficher ou masquer, comme un calque posé sur un plan. Un plan peut garder ses cotes sur l'un et ses notes sur l'autre, et un calque peut être réglé pour s'afficher à l'écran et rester hors de l'impression.