API kodów kreskowych dla programistów

Generuj obrazy kodów kreskowych z własnej aplikacji jednym żądaniem HTTP GET. Bez klucza API, bez rejestracji, bez znaków wodnych — po prostu URL zwracający PNG lub SVG.

⚡ Endpoint

GET https://barcodeready.com/api/barcode?type=ean13&data=5901234123457

Odpowiedzią jest sam obraz, więc URL działa bezpośrednio w tagu <img>, arkuszu kalkulacyjnym, szablonie dokumentu WMS lub dowolnym kliencie HTTP. CORS jest włączony, a odpowiedzi są cache'owane przez 24 godziny.

▶ Przykład na żywo

EAN-13 barcode generated by the BarcodeReady API

                        <!-- Ten obraz jest generowany przez API w locie -->

                        <img src="https://barcodeready.com/api/barcode?type=ean13&data=5901234123457">

⚙ Parametry zapytania

Parametr	Wymagany	Opis
type	tak	Typ kodu — lista obsługiwanych typów poniżej.
data	tak	Treść do zakodowania (maks. 500 znaków). Pamiętaj o URL-encodingu znaków specjalnych.
format	nie	Format wyjściowy: png (domyślny) lub svg.
scale	nie	Skala modułu od 1 do 8. Domyślnie: 3. Wyższe wartości dają większe, ostrzejsze PNG.
height	nie	Wysokość kresek w milimetrach dla kodów 1D (5-60). Domyślnie: 12. Ignorowany dla QR, DataMatrix i PDF417.
includetext	nie	Drukuj tekst czytelny dla człowieka pod kodem: true (domyślnie) lub false.

▦ Obsługiwane typy kodów

code128 — CODE128 gs1-128 — GS1-128 ean13 — EAN-13 ean8 — EAN-8 upca — UPC-A itf14 — ITF-14 code39 — CODE39 qrcode — QR Code datamatrix — DataMatrix pdf417 — PDF417

</> Przykłady kodu

cURL

curl -o barcode.png "https://barcodeready.com/api/barcode?type=code128&data=INV-2026-001"

JavaScript

const res = await fetch('https://barcodeready.com/api/barcode?type=qrcode&data=hello&format=svg');
const svg = await res.text();

Python

import requests

r = requests.get("https://barcodeready.com/api/barcode",
    params={"type": "ean13", "data": "5901234123457", "format": "png"})
with open("barcode.png", "wb") as f:
    f.write(r.content)

PHP

file_put_contents('barcode.png',
    file_get_contents('https://barcodeready.com/api/barcode?type=itf14&data=15901234123457'));

! Obsługa błędów

Błędne żądania zwracają HTTP 400 z treścią JSON opisującą problem, w tym walidację zgodności ze standardami z silnika generującego (zła cyfra kontrolna, zła długość, niedozwolone znaki).

{ "error": "bwipp.ean13badLength: EAN-13 must be 12 or 13 digits", "docs": "https://barcodeready.com/developers" }

Zasady korzystania

API jest darmowe do rozsądnego użytku produkcyjnego i ma limity żądań per adres IP. Jeśli osadzasz je w publicznym produkcie lub dokumentacji, będzie nam miło za link do barcodeready.com. Przy dużych wolumenach napisz przez stronę kontaktową.

Powrót do generatora Kontakt