API codici a barre per sviluppatori

Genera immagini di codici a barre dalla tua applicazione con una singola richiesta HTTP GET. Nessuna chiave API, nessuna registrazione, nessuna filigrana — solo un URL che restituisce un PNG o un SVG.

⚡ Endpoint

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

La risposta è l'immagine stessa: l'URL funziona direttamente in un tag <img>, in un foglio di calcolo, in un modello di documento WMS o in qualsiasi client HTTP. CORS è abilitato e le risposte sono in cache per 24 ore.

▶ Esempio dal vivo

EAN-13 barcode generated by the BarcodeReady API

                        <!-- Questa immagine è generata dall'API al volo -->

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

⚙ Parametri della richiesta

Parametro	Obbligatorio	Descrizione
type	sì	Tipo di codice — vedi l'elenco dei tipi supportati qui sotto.
data	sì	Contenuto da codificare (max 500 caratteri). Ricorda di codificare i caratteri speciali nell'URL.
format	no	Formato di output: png (predefinito) o svg.
scale	no	Scala del modulo da 1 a 8. Predefinito: 3. Valori più alti producono PNG più grandi e nitidi.
height	no	Altezza delle barre in millimetri per i codici 1D (5-60). Predefinito: 12. Ignorato per QR, DataMatrix e PDF417.
includetext	no	Stampa il testo leggibile sotto il codice: true (predefinito) o false.

▦ Tipi di codice supportati

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

</> Esempi di codice

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'));

! Gestione degli errori

Le richieste non valide restituiscono HTTP 400 con un corpo JSON che descrive il problema, inclusa la validazione degli standard del motore di generazione (cifra di controllo errata, lunghezza errata, caratteri non validi).

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

Uso corretto

L'API è gratuita per un uso di produzione ragionevole ed è limitata per indirizzo IP. Se la integri in un prodotto pubblico o nella documentazione, un link a barcodeready.com è apprezzato. Per volumi elevati, contattaci tramite la pagina dei contatti.

Torna al generatore Contatti