API per immagini di codici a barre
Una URL, un’immagine di codice a barre — senza chiave, senza SDK e senza registrazione. Puntaci un tag HTML <img>, un link di Markdown o una formula di un foglio di calcolo e funziona.
Dal vivo — questa immagine la sta generando in questo momento l’endpoint qui sotto.
https://www.barcodesheets.com/api/barcode?data=SKU-12345&type=code128Parametri
| Parametro | Predefinito | Limiti | Descrizione |
|---|---|---|---|
| data | obbligatorio | 1–256 caratteri | Il valore da codificare. Le cifre di controllo (EAN-13, UPC-A, ITF-14, ISBN, …) vengono completate in automatico, con la stessa regola del generatore del sito. Codifica i caratteri speciali nella URL (un + letterale viene letto come spazio, secondo la convenzione consueta delle stringhe di query che ogni consumatore di URL e di =IMAGE() si aspetta). |
| type | code128 | un id di simbologia riconosciuto (vedi la tabella qui sotto) | Quale simbologia di codice a barre viene disegnata. |
| scale | 3 | 1–8 | Moltiplicatore della larghezza di modulo. Valori più alti danno un’immagine più grande e a risoluzione maggiore: alzalo per la stampa, abbassalo per un inserto piccolo dentro il testo. |
| fmt | png | png oppure svg | Formato dell’immagine restituita. L’SVG si ingrandisce a qualsiasi misura senza perdere qualità; il PNG è la scelta predefinita più sicura per fogli di calcolo e CMS che non mostrano l’SVG. |
| addon | nessuno | esattamente 5 cifre — solo con isbn | Supplemento di prezzo EAN-5, applicato solo con type=isbn (equivale al campo del supplemento di prezzo del generatore ISBN). Con qualsiasi altro tipo viene ignorato. |
| text | valore predefinito della simbologia | 0 oppure 1 | Se i caratteri leggibili vengono stampati sotto le barre. text=0 forza le sole barre; text=1 forza la riga di testo; se lo ometti vale il valore predefinito di ogni simbologia (attivo sulla maggior parte dei tipi, disattivo su Data Matrix/QR). Qualsiasi altro valore restituisce un 400. |
Frammenti da copiare e incollare
<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")Che cosa fa questo endpoint
GET /api/barcode accetta gli stessi parametri data/type/scale che usa il generatore del sito e restituisce un’immagine di codice a barre vera, già generata — PNG per impostazione predefinita, oppure SVG con fmt=svg — invece di una pagina web. Punta a quella URL un qualsiasi tag HTML <img>, un link a immagine di Markdown o una formula =IMAGE() di un foglio di calcolo, e il codice a barre compare ovunque la URL sia incorporata, senza passaggi intermedi di scaricamento e reinserimento. Le cifre di controllo vengono completate in automatico sui tipi della famiglia GTIN, come nel generatore: un data= di 12 cifre con type=ean13 diventa, nell’immagine restituita, un EAN-13 vero di 13 cifre che si legge senza problemi.
Uso ragionevole — limiti generosi e nessuna chiave
Non c’è nessun account, nessuna chiave API, nessuna autenticazione di alcun genere: tutti i parametri che ti servono stanno nella URL stessa. I limiti sono generosi di proposito, invece che a consumo: fino a 256 caratteri in data= e un intervallo di scale= da 1 a 8. Ogni risposta riuscita porta l’intestazione Cache-Control: public, max-age=31536000, s-maxage=31536000, immutable, quindi quella stessa URL resta in cache per un anno sia nei browser sia nelle CDN — un foglio di calcolo con mille righe che punta a questo endpoint genera ogni codice a barre unico una volta sola. L’abuso vero è affare della piattaforma di hosting, non qualcosa imposto da questa rotta. Anche il CORS è completamente aperto (Access-Control-Allow-Origin: * su ogni risposta, di successo o di errore), quindi fare fetch() della URL dal JavaScript di un altro sito — per disegnarla in un <canvas> o incorporarla come data URL, e non solo come tag HTML <img> — funziona da qualsiasi origine.
Tipi di codice a barre riconosciuti
| type= | Codice a barre | Categoria |
|---|---|---|
| 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 |
Domande frequenti
L’API per i codici a barre è gratis?
GET /api/barcode è gratis e senza limiti — nessuna chiave API, nessun account e nessun tetto per richiesta. È un endpoint di immagini pubblico, fatto perché tu lo punti da un foglio di calcolo, da un CMS o da un README, come qualsiasi altra URL di immagine.Si può usare in Fogli Google?
=IMAGE("https://www.barcodesheets.com/api/barcode?data=IL-TUO-VALORE&type=code128") in una cella (o punta data= al valore di un’altra cella) e il codice a barre compare lì dentro, aggiornandosi da solo se il valore cambia. Excel 365 (collegato al cloud) accetta la stessa formula =IMAGE().C’è un limite di richieste?
Che tipi di codice a barre accetta l’API?
type= che trovi nell’elenco dei tipi qui sotto e nella pagina di ogni simbologia (ad es. /isbn per l’id isbn).Continua a esplorare
Genera centinaia di codici a barre in una volta a partire da un foglio di calcolo.
Stampare fogli di etichettePDF pronti per Avery con zone di rispetto corrette, allineati da soli.
Tutti i tipi di codice a barreScopri tutte le simbologie con cui BarcodeSheets è compatibile.