Un code Data Matrix, très petit et très solide
Dessiner un code Data Matrix, celui des colis et des petites pièces : autant de contenu qu'un code QR dans beaucoup moins de place.
Résumé
On le trouve sur les colis, sur les flacons de médicament, et gravé à même les pièces mécaniques — ce qui en fait le préféré des étiquettes minuscules. Vous donnez le texte et le cadre, et le carré se dessine avec sa marge blanche sur les quatre côtés. Là où l'étiquette est une bande étroite plutôt qu'un carré — un tube d'échantillon, une pièce, un ruban adhésif — vous demandez la forme oblongue à la place, et le code la suit. Il supporte bien la saleté et les petites griffures, ce qui est pratique quand l'étiquette voyage.
Techniquement
Demandé avec
"type": "data_matrix"
L'encodage suit le schéma ASCII en ECC 200, la correction moderne de la norme, et les modules sont dessinés comme des carrés pleins dans le flux de contenu de la page. Le symbole et sa zone de silence sur ses quatre côtés remplissent la largeur du rectangle, ancrés au coin inférieur gauche : la largeur commande, la hauteur du rectangle est du dégagement. Sans rien dire de plus, le symbole est le plus petit carré qui transporte le texte, de 10 sur 10 modules à 144 sur 144. Un symbole oblong peut être demandé à la place — le plus petit des six que la norme prévoit, de 8 sur 18 à 16 sur 48 — et, plus large que haut, il laisse le haut du rectangle vide. Le symbole exact peut aussi être énoncé en modules, en hauteur et en largeur, pour qu'une série d'étiquettes sorte à une seule taille quel que soit ce que chacune transporte. Énoncer à la fois la forme et le symbole exact est refusé, et un texte plus long que le symbole demandé répond 400. Comme les autres codes, l'élément dessine le symbole seul.
Schéma de la requête
Clés obligatoires : content, une chaîne ; rect. Facultatives : shape, soit square (par défaut), soit rectangle ; size, un objet de height et de width en modules, le symbole étant pris exactement tel qu'il est énoncé, si peu que le texte en remplisse ; 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és : transform avec rotate, et shape avec size. Le schéma d'encodage et le niveau de correction sont fixés au schéma ASCII et à l'ECC 200.
Une requête entière qui crée un PDF
{
"items": [
{
"type": "data_matrix",
"content": "SN:2026-08-08/ACME-4472",
"shape": "square",
"rect": {"llx": 72, "lly": 700, "urx": 132, "ury": 760}
}
]
}
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 PDF417, qui contient tout un formulaire
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