API d’images de code-barres
Une URL, une image de code-barres — sans clé, sans SDK, sans inscription. Pointez vers elle une balise HTML <img>, un lien Markdown ou une formule de tableur, et cela fonctionne, tout simplement.
En direct — cette image est générée à l’instant même par l’endpoint ci-dessous.
https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128Paramètres
| Paramètre | Par défaut | Limites | Description |
|---|---|---|---|
| data | obligatoire | 1–256 caractères | La valeur à coder. Les chiffres de contrôle (EAN-13, UPC-A, ITF-14, ISBN, …) sont complétés automatiquement — la même règle que dans le générateur du site. Encodez les caractères spéciaux dans l’URL (un + littéral se lit comme un espace, selon la convention habituelle des chaînes de requête qu’attendent déjà tous les consommateurs d’URL et de =IMAGE()). |
| type | code128 | un id de symbologie pris en charge (voir le tableau ci-dessous) | La symbologie de code-barres à générer. |
| scale | 3 | 1–8 | Multiplicateur de la largeur de module. Les valeurs plus élevées donnent une image plus grande et mieux définie — montez-la pour l’impression, baissez-la pour une petite intégration dans le texte. |
| fmt | png | png ou svg | Format d’image renvoyé. Le SVG s’adapte à toutes les tailles sans perte de qualité ; le PNG est l’option par défaut la plus sûre pour les tableurs et les CMS qui n’affichent pas le SVG. |
| addon | aucun | exactement 5 chiffres — uniquement avec isbn | Complément de prix EAN-5, appliqué uniquement avec type=isbn (l’équivalent du champ complément de prix du générateur ISBN). Ignoré pour tout autre type. |
| text | valeur par défaut de la symbologie | 0 ou 1 | Indique si les caractères lisibles sont imprimés sous les barres. text=0 force les barres seules ; text=1 force la ligne de texte ; si vous l’omettez, la valeur par défaut de chaque symbologie s’applique (activée pour la plupart des types, désactivée pour Data Matrix/QR). Toute autre valeur renvoie une erreur 400. |
Fragments à copier-coller
<img src="https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128" alt="Barcode for SKU-12345" width="300" height="100" />=IMAGE("https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128")Ce que fait cet endpoint
GET /api/barcode accepte les mêmes paramètres data/type/scale que le générateur du site et renvoie une véritable image de code-barres générée — un PNG par défaut, ou un SVG avec fmt=svg — au lieu d’une page web. Pointez vers cette URL n’importe quelle balise HTML <img>, un lien d’image Markdown ou une formule =IMAGE() de tableur, et le code-barres apparaît partout où cette URL est intégrée, sans passer par une étape de téléchargement puis de nouvel envoi. Les chiffres de contrôle sont complétés automatiquement pour les types de la famille GTIN, exactement comme dans le générateur — un data= de 12 chiffres avec type=ean13 devient, dans l’image renvoyée, un vrai EAN-13 de 13 chiffres qui se lit sans problème.
Usage raisonnable — des limites généreuses, sans clé
Il n’y a ni compte, ni clé d’API, ni authentification d’aucune sorte — tous les paramètres dont vous avez besoin sont dans l’URL elle-même. Les limites sont volontairement généreuses plutôt que facturées à l’usage : jusqu’à 256 caractères dans data=, et une plage de scale= de 1 à 8. Chaque réponse réussie porte l’en-tête Cache-Control: public, max-age=31536000, s-maxage=31536000, immutable, si bien que cette même URL reste en cache un an entier aussi bien dans les navigateurs que dans les CDN — un tableur de mille lignes pointé vers cet endpoint ne génère donc chaque code-barres unique qu’une seule fois. Les abus réels relèvent de la plateforme d’hébergement, pas de cette route. CORS est lui aussi complètement ouvert (Access-Control-Allow-Origin: * sur chaque réponse, en cas de succès comme d’erreur), si bien qu’un fetch() vers cette URL depuis le JavaScript d’un autre site — pour la dessiner sur un <canvas> ou l’intégrer comme data URL, et pas seulement comme une simple balise HTML <img> — fonctionne aussi depuis n’importe quelle origine.
Types de codes-barres pris en charge
| type= | Code-barres | Catégorie |
|---|---|---|
| code128 | Code 128 | General |
| code39 | Code 39 | General |
| ean13 | EAN-13 | Retail |
| ean8 | EAN-8 | Retail |
| upca | UPC-A | Retail |
| upce | UPC-E | Retail |
| itf14 | ITF-14 | Logistics |
| gs1-128 | GS1-128 | Logistics |
| datamatrix | Data Matrix | 2D |
| qrcode | QR Code | 2D |
| isbn | ISBN | Retail |
Questions fréquentes
L’API de codes-barres est-elle gratuite ?
GET /api/barcode est gratuit et sans limite — sans clé d’API, sans compte et sans plafond par requête. C’est un endpoint d’images public, pensé pour être appelé en direct depuis un tableur, un CMS ou un README, exactement comme n’importe quelle autre URL d’image.Puis-je l’utiliser dans Google Sheets ?
=IMAGE("https://www.barcodesheets.com/api/barcode?data=VOTRE-VALEUR&type=code128") dans une cellule (ou pointez data= vers la valeur d’une autre cellule) et le code-barres s’affiche là, et il se met à jour tout seul si la valeur change. Excel 365 (connecté au cloud) prend en charge la même formule =IMAGE().Y a-t-il une limite de requêtes ?
Quels types de codes-barres l’API prend-elle en charge ?
type= que celui indiqué dans la liste des types ci-dessous et sur la page de chaque symbologie (p. ex. /isbn pour l’id isbn).Pour aller plus loin
Générez des centaines de codes-barres d’un coup depuis un tableur.
Imprimer des planches d’étiquettesDes PDF prêts pour Avery, avec des zones de silence correctes, alignés automatiquement.
Tous les types de codes-barresParcourez toutes les symbologies que BarcodeSheets prend en charge.