Barcode-Bild-API
Eine URL, ein Barcode-Bild — ohne Schlüssel, ohne SDK, ohne Anmeldung. Richten Sie ein <img>-Tag, einen Markdown-Link oder eine Tabellenformel darauf, und es funktioniert einfach.
Live — dieses Bild wird gerade jetzt vom Endpunkt unten erzeugt.
https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128Parameter
| Parameter | Vorgabe | Grenzen | Beschreibung |
|---|---|---|---|
| data | erforderlich | 1–256 Zeichen | Der zu codierende Wert. Prüfziffern (EAN-13, UPC-A, ITF-14, ISBN, …) werden automatisch ergänzt — dieselbe Regel wie im Generator auf der Website. Sonderzeichen URL-codieren (ein einfaches + wird als Leerzeichen gelesen, nach der üblichen Query-String-Konvention, die jeder URL- und =IMAGE()-Konsument erwartet). |
| type | code128 | eine unterstützte Symbologie-ID (siehe Tabelle unten) | Welche Barcode-Symbologie gerendert wird. |
| scale | 3 | 1–8 | Faktor für die Modulbreite. Höhere Werte ergeben ein größeres, höher aufgelöstes Bild — für den Druck hochdrehen, für eine kleine Einbettung im Text herunter. |
| fmt | png | png oder svg | Zurückgegebenes Bildformat. SVG skaliert verlustfrei auf jede Größe; PNG ist die sicherere Wahl für Tabellen und CMS, die kein SVG darstellen. |
| addon | keines | genau 5 Ziffern — nur bei isbn | EAN-5-Preis-Add-on, wird nur bei type=isbn angewendet (entspricht dem Preisfeld im ISBN-Studio). Bei jedem anderen Typ ignoriert. |
| text | Vorgabe der Symbologie | 0 oder 1 | Ob die lesbare Zeichenfolge unter den Strichen gedruckt wird. text=0 erzwingt reine Striche, text=1 erzwingt die Textzeile; ohne Angabe gilt die Vorgabe der jeweiligen Symbologie (bei den meisten Typen an, bei Data Matrix/QR aus). Jeder andere Wert führt zu einem 400. |
Schnipsel zum Kopieren
<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")Was dieser Endpunkt macht
GET /api/barcode nimmt dieselben Parameter für data/type/scale entgegen wie der Generator auf der Website und gibt ein echtes, gerendertes Barcode-Bild zurück — standardmäßig PNG, mit fmt=svg als SVG — statt einer Webseite. Richten Sie ein beliebiges <img>-Tag, einen Markdown-Bildlink oder eine =IMAGE()-Formel in der Tabelle auf die URL, und der Barcode erscheint überall dort, wo diese URL eingebettet ist, ganz ohne Zwischenschritt aus Herunterladen und Hochladen. Prüfziffern werden für die Formate der GTIN-Familie genauso automatisch ergänzt wie im Generator — aus einem 12-stelligen data= unter type=ean13 wird im zurückgegebenen Bild ein echter, scanbarer 13-stelliger EAN-13.
Faire Nutzung — großzügige Grenzen, kein Schlüssel nötig
Es gibt kein Konto, keinen API-Schlüssel und keinerlei Authentifizierung — jeder Parameter, den Sie brauchen, steht direkt in der URL. Die Grenzen sind bewusst großzügig statt abgerechnet: bis zu 256 Zeichen data=, ein scale=-Bereich von 1 bis 8. Jede erfolgreiche Antwort trägt den Header Cache-Control: public, max-age=31536000, s-maxage=31536000, immutable, sodass dieselbe URL ein Jahr lang von Browsern und CDNs zwischengespeichert wird — eine Tabelle mit tausend Zeilen, die auf diesen Endpunkt zeigt, rendert jeden einzelnen Barcode also nur einmal. Echter Missbrauch ist eine Sache der Hosting-Plattform, nicht etwas, das diese Route selbst durchsetzt. Auch CORS ist offen (Access-Control-Allow-Origin: * bei jeder Antwort, ob Erfolg oder Fehler), sodass ein fetch() auf die URL aus dem JavaScript einer anderen Website — um sie auf ein <canvas> zu zeichnen oder als Data-URL einzubetten, statt nur als schlichtes <img> — von jeder Herkunft aus funktioniert.
Unterstützte Barcodetypen
| type= | Barcode | Kategorie |
|---|---|---|
| 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 |
Häufige Fragen
Ist die Barcode-API kostenlos?
GET /api/barcode ist kostenlos und unbegrenzt — kein API-Schlüssel, kein Konto, keine Obergrenze pro Anfrage. Es ist ein öffentlicher Bild-Endpunkt, gedacht zum Einbinden aus einer Tabelle, einem CMS oder einer README, genau wie jede andere Bild-URL.Kann ich sie in Google Sheets nutzen?
=IMAGE("https://www.barcodesheets.com/api/barcode?data=IHR-WERT&type=code128") in eine Zelle (oder verweisen Sie für data= auf den Wert einer anderen Zelle), und der Barcode erscheint direkt dort und aktualisiert sich automatisch, wenn sich der Wert ändert. Excel 365 (mit Cloud-Anbindung) unterstützt dieselbe =IMAGE()-Formel.Gibt es ein Anfragelimit?
Welche Barcodetypen unterstützt die API?
type=-ID, die in der Typenliste unten und auf der jeweiligen Symbologie-Seite steht (etwa /isbn für die ID isbn).