Ai-je besoin d’une clé API pour générer des codes-barres ?

Non. Le niveau gratuit permet un accès anonyme à 5 requêtes par minute avec une limitation de débit basée sur IP. Pour les charges de travail de production, ajoutez une clé API dans l’en-tête Autorisation pour augmenter la limite.

Puis-je obtenir un PNG au lieu de SVG ?

L'API renvoie SVG dans une réponse JSON. SVG s'adapte à n'importe quelle résolution sans pixellisation, ce qui le rend idéal pour les imprimantes d'étiquettes thermiques à 203 ou 300 DPI. Pour convertir en PNG, rastérisez le SVG avec Sharp, Inkscape ou un élément de canevas de navigateur.

Quels caractères puis-je encoder dans Code128 ?

Code128B prend en charge les caractères ASCII imprimables depuis l'espace (0x20) jusqu'au tilde (0x7E). Cela couvre les lettres majuscules et minuscules, les chiffres, la ponctuation et les symboles courants. Pour les données uniquement numériques telles que les GTIN, utilisez EAN-13, EAN-8 ou UPC-A.

Comment intégrer le code-barres SVG dans un PDF ?

Extrayez le champ svg de la réponse JSON et transmettez-le à votre bibliothèque PDF. Des bibliothèques comme Puppeteer, wkhtmltopdf et WeasyPrint rendent le SVG en ligne de manière native. Pour reportlab ou jsPDF, convertissez d'abord le SVG en PNG avec Sharp ou Canvas.

Quelle est la longueur maximale des données ?

Le Code128 peut encoder des chaînes jusqu'à environ 80 caractères avant que le code-barres ne devienne trop large pour les imprimantes d'étiquettes standard. EAN-13 est fixé à 13 chiffres, EAN-8 à 8, UPC-A à 12 et ITF-14 à 14. Gardez les données courtes pour une analyse fiable.

Tutorial

API du générateur de codes-barres : une sortie POST, SVG, six formats

29 mars 2026 | 5 min read

Générez des codes-barres avec un seul appel API. Prend en charge les codes 128, EAN-13, EAN-8, UPC-A, ITF-14 et MSI. Renvoie un SVG que vous pouvez intégrer dans des étiquettes, des factures ou des PDF.

Close-up of barcodes on product packaging — Photo by Markus Winkler on Unsplash

Votre application d'entrepôt imprime les étiquettes d'expédition. Chaque étiquette nécessite un code-barres Code128 pour le suivi numéro. Vous pouvez installer une bibliothèque de codes-barres, effectuer le rendu sur le canevas, l'exporter au format PNG et l'intégrer dans votre modèle d'étiquette. Ou vous pouvez envoyer un POST et récupérer un SVG.

Le botoï /v1/barcode le point de terminaison encode les données dans six formats de codes-barres et renvoie une chaîne SVG dans une réponse JSON. Pas de package npm. Aucune étape de construction. Aucune dépendance au canevas.

L'appel API

Envoyez une requête POST avec les données et le format :

La réponse enveloppe le SVG dans une enveloppe JSON standard :

Extraire le svg champ, déposez-le dans un <img> tag, insérez-le en HTML, ou dirigez-le vers un fichier. Le rendu SVG est net quelle que soit la taille car il est vectoriel ; aucun artefact de rastérisation à 300 DPI ou plus.

Paramètres

Le point de terminaison accepte cinq paramètres. Seulement data est requis :

données (chaîne, obligatoire) : la valeur à encoder. Pour EAN-13, passez 13 chiffres. Pour Code128, transmettez n’importe quelle chaîne ASCII imprimable.
format (chaîne, par défaut code128): L'un des code128, ean-13, ean-8, upc-a, itf-14, ou msi.
largeur (nombre, 200 par défaut) : largeur de l'image en pixels. Plage : 50 à 2000.
hauteur (nombre, 80 par défaut) : hauteur de l'image en pixels. Plage : 20 à 1000.
show_text (booléen, par défaut true) : s'il faut rendre le valeur codée sous forme de texte sous les barres.

Voici un code-barres Code128 avec tous les paramètres définis :

Exemples pratiques

Génération d'étiquettes d'expédition

Encodez un numéro de suivi en tant que Code128 pour les bons de livraison et les étiquettes d'expédition. Poignées Code128 chaînes alphanumériques mixtes, de sorte que les numéros de suivi tels que "1Z999AA10123456784" fonctionnent sans prétraitement.

Système de gestion des stocks

Imprimez des étiquettes Code128 pour les bacs et les étagères d'entrepôt. Le personnel les scanne avec des lecteurs portables pendant le prélèvement et l'emballage. Le code-barres code le chemin de localisation complet : entrepôt, étagère, bac.

Étiquettes de produits de vente au détail (EAN-13)

EAN-13 est la norme internationale pour les produits de vente au détail. Passez le GTIN à 13 chiffres et l'API renvoie un SVG dimensionné pour les étiquettes de bord d'étagère standard.

Génération par lots Node.js pour un catalogue de produits

Générez des codes-barres pour l’ensemble d’un catalogue de produits en parallèle. Ce script déclenche quatre requêtes simultanément et collecte les chaînes SVG :

Sortir:

Pour les catalogues contenant des centaines de produits, regroupez-les par groupes de 20 à 50 pour rester dans les limites de tarifs. Le niveau gratuit est limité à 5 requêtes par minute ; une clé API supprime cette limite.

Exemple Node.js : étiquettes de codes-barres pour l'exécution des commandes

Ce serveur Express expose un /labels/:orderId point final. Quand ton épanouissement Le système ou l'imprimante d'étiquettes récupère cette URL, il récupère un code-barres SVG codant pour la commande. numéro de suivi.

Usage:

L'en-tête de cache de 24 heures empêche les appels d'API en double pour la même commande. En production, ajoutez un cache CDN ou Redis devant cette route.

Quand utiliser quel format

Le Code128 est la valeur par défaut pour une raison : il code la plus large gamme de caractères et fonctionne pour la plupart des systèmes internes. Passez à EAN-13 ou UPC-A lorsque votre produit a besoin d'un document numérisable au détail. code à barres. Utilisez ITF-14 pour les étiquettes extérieures des cartons dans la logistique. MSI s'adapte à l'étiquetage des étagères des entrepôts où vous avez besoin de codes uniquement numériques avec un simple chiffre de contrôle.

Points clés

Le niveau gratuit à 5 requêtes par minute couvre le développement, les tests et l'étiquetage à faible volume impression. Pour les systèmes de génération par lots ou de traitement des commandes à fort trafic, transmettez votre clé API dans le Authorization: Bearer en-tête. Vérifiez le Documents sur l'API pour la référence complète du point final.

FAQ

Ai-je besoin d’une clé API pour générer des codes-barres ?: Non. Le niveau gratuit permet un accès anonyme à 5 requêtes par minute avec une limitation de débit basée sur IP. Pour les charges de travail de production, ajoutez une clé API dans l’en-tête Autorisation pour augmenter la limite.
Puis-je obtenir un PNG au lieu de SVG ?: L'API renvoie SVG dans une réponse JSON. SVG s'adapte à n'importe quelle résolution sans pixellisation, ce qui le rend idéal pour les imprimantes d'étiquettes thermiques à 203 ou 300 DPI. Pour convertir en PNG, rastérisez le SVG avec Sharp, Inkscape ou un élément de canevas de navigateur.
Quels caractères puis-je encoder dans Code128 ?: Code128B prend en charge les caractères ASCII imprimables depuis l'espace (0x20) jusqu'au tilde (0x7E). Cela couvre les lettres majuscules et minuscules, les chiffres, la ponctuation et les symboles courants. Pour les données uniquement numériques telles que les GTIN, utilisez EAN-13, EAN-8 ou UPC-A.
Comment intégrer le code-barres SVG dans un PDF ?: Extrayez le champ svg de la réponse JSON et transmettez-le à votre bibliothèque PDF. Des bibliothèques comme Puppeteer, wkhtmltopdf et WeasyPrint rendent le SVG en ligne de manière native. Pour reportlab ou jsPDF, convertissez d'abord le SVG en PNG avec Sharp ou Canvas.
Quelle est la longueur maximale des données ?: Le Code128 peut encoder des chaînes jusqu'à environ 80 caractères avant que le code-barres ne devienne trop large pour les imprimantes d'étiquettes standard. EAN-13 est fixé à 13 chiffres, EAN-8 à 8, UPC-A à 12 et ITF-14 à 14. Gardez les données courtes pour une analyse fiable.

Commencez a construire avec botoi

150+ endpoints API pour la recherche, le traitement de texte, la generation d'images et les utilitaires pour developpeurs. Offre gratuite, sans carte bancaire.

Voir la documentation API Voir tous les outils