Un'API per codice QR ti consente di generare codici QR programmaticamente - dalla tua applicazione web, app mobile, sistema backend o pipeline di automazione. Invece di creare manualmente codici QR uno alla volta tramite un'interfaccia web, invii una richiesta HTTP e ottieni un'immagine del codice QR in millisecondi. Se hai bisogno di generare codici QR su larga scala, integrarli nel tuo prodotto o automatizzare workflow che coinvolgono ponti fisico-digitale, un'API è la soluzione giusta.
Questa guida copre i migliori punti di integrazione per un'API codice QR in sistemi web, mobile e backend. Imparerai come funzionano le API per codice QR, vedrai esempi di codice copia-incolla in quattro linguaggi, confronterai i principali provider e uscirai con best practice pronte per la produzione. Che tu stia costruendo un checkout e-commerce, un sistema di etichette di spedizione o una pipeline di automazione marketing, questa è la tua guida completa per l'integrazione API codice QR.
Punti Chiave
- Un'API codice QR trasforma la creazione manuale in generazione automatizzata: da migliaia di codici in minuti, non giorni
- I 6 migliori punti di integrazione: e-commerce, dashboard SaaS, app mobile, CRM/ERP, automazione marketing e sistemi POS
- Usa sempre codici QR dinamici via API per poter correggere errori, fare A/B test e tracciare analytics senza ristampare
- Non esporre mai le chiavi API nel codice lato client: proxy sempre le richieste tramite il backend
- QR-Verse offre arte QR con IA, analytics delle scansioni e generazione bulk - funzionalita uniche rispetto ai concorrenti
Perché Integrare i Codici QR via API?
La creazione manuale di codici QR funziona quando hai bisogno di una manciata di codici. Ma nel momento in cui il tuo business scala - centinaia di etichette prodotto, migliaia di biglietti per eventi, mailer marketing personalizzati - la creazione manuale diventa un collo di bottiglia.
Ecco cosa sblocca un'API:
- Automazione. Genera codici QR come parte dei tuoi workflow esistenti. Un nuovo ordine attiva un'etichetta di spedizione con un codice QR. Un nuovo utente riceve un codice QR personalizzato di onboarding. Nessun intervento umano.
- Scala. Crea 10.000 codici QR in minuti, non giorni. Gli endpoint di generazione bulk elaborano i batch in modo efficiente.
- Contenuto dinamico. I codici QR dinamici ti consentono di cambiare l'URL di destinazione dopo che il codice è stato stampato. L'API ti dà il pieno controllo sulla creazione e l'aggiornamento di questi codici programmaticamente.
- Coerenza. Ogni codice QR segue lo stesso design, livello di correzione degli errori e linee guida del brand. Nessun errore isolato.
- Analytics. Traccia ogni scansione con timestamp, posizione e dati del dispositivo. I codici dinamici generati via API si integrano automaticamente nella tua pipeline analytics.
Se non conosci la differenza tra codici QR statici e dinamici, leggi prima la nostra guida completa al confronto. Per l'integrazione API, i codici QR dinamici sono quasi sempre la scelta giusta perché puoi aggiornare le destinazioni senza ristampare.
Migliori Punti di Integrazione dell'API Codice QR in Sistemi Web, Mobile e Backend
Questa è la sezione che la maggior parte degli sviluppatori sta cercando. Ecco i sei punti di integrazione più efficaci, con esempi concreti e guida all'architettura per ciascuno.
Applicazioni Web
Le piattaforme e-commerce sono il punto di integrazione con il maggior impatto. Genera un codice QR univoco per ogni pagina di conferma ordine, bolla di accompagnamento e ricevuta digitale. Quando scansionato, il codice QR può rimandare al tracciamento dell'ordine, a un portale di reso o a una pagina di recensione del prodotto.
I dashboard SaaS che servono le aziende traggono enorme vantaggio dalla generazione QR integrata. Consenti ai tuoi utenti di creare codici QR brandizzati senza lasciare la tua piattaforma - che si tratti di un sistema di gestione ristorante che genera codici QR per menu, un CRM che crea codici QR vCard per i rappresentanti di vendita, o una piattaforma di prenotazione che produce codici di conferma.
I sistemi di prenotazione e prenotazione possono allegare un codice QR a ogni email di conferma e pagina di check-in. Hotel, compagnie aeree e sedi di eventi usano codici QR generati via API come carte d'imbarco digitali e token di check-in.
Pattern di implementazione per app web:
// Gestore di route lato server (esempio di route API Next.js)
export async function POST(request) {
const { url, label } = await request.json()
const response = await fetch('https://api.qr-verse.com/v1/qr-codes', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.QR_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
type: 'url',
data: url,
options: {
size: 512,
format: 'png',
errorCorrection: 'H',
label: label
}
})
})
const qrCode = await response.json()
return Response.json(qrCode)
}
Non chiamare mai un'API codice QR direttamente da JavaScript lato client. La tua chiave API sarebbe visibile negli strumenti per sviluppatori del browser. Proxy sempre le richieste attraverso il tuo server backend.
App Mobile
Il mobile è dove i codici QR brillano perché la fotocamera è proprio lì. Se la tua app genera codici QR che gli utenti possono condividere, una chiamata API dal tuo backend è più pulita e affidabile di una libreria lato client.
Le app React Native e Flutter dovrebbero chiamare il tuo backend, che poi chiama l'API codice QR. Il backend restituisce l'immagine del codice QR (come URL o stringa base64) al client mobile. Questo mantiene sicura la tua chiave API e ti consente di aggiungere caching.
Le app iOS e Android native seguono lo stesso pattern. Il tuo codice Swift o Kotlin invia una richiesta al tuo endpoint API, che gestisce la generazione del codice QR lato server.
Casi d'uso comuni per il mobile:
- Carte fedeltà digitali - ogni cliente riceve un codice QR univoco che il cassiere scansiona
- Condivisione peer-to-peer - condividi un biglietto da visita, una password WiFi o un link di pagamento come codice QR
- Wallet biglietti - biglietti per eventi con codici QR scansionabili per l'ingresso
- App per biglietti da visita - genera codici QR vCard dai dati di contatto
Sistemi Backend
L'integrazione backend è dove le API codice QR offrono il maggior valore su larga scala. Questi sono sistemi in cui nessun essere umano fa clic su "genera" - i codici QR vengono creati come parte di processi aziendali automatizzati.
Sistemi CRM (Salesforce, HubSpot, personalizzati) - allega un codice QR a ogni nuovo record di contatto. I rappresentanti di vendita possono stampare un foglio di codici QR personalizzati che rimandano alla loro pagina di prenotazione del calendario. Consulta la nostra guida al marketing per ulteriori strategie QR nell'acquisizione clienti.
Sistemi ERP e di inventario - genera codici QR per il tracciamento degli asset, le ubicazioni dei contenitori in magazzino e l'instradamento dei lavori in corso. Ogni elemento ottiene un codice univoco che rimanda alla sua cronologia completa.
Spedizione e logistica - crea codici QR per etichette di spedizione che rimandano a pagine di tracciamento in tempo reale. A differenza dei codici a barre, i codici QR possono codificare abbastanza dati per un URL di tracciamento completo con parametri di query.
import requests
def genera_qr_spedizione(numero_tracking, corriere):
"""Genera un codice QR per un'etichetta di spedizione."""
url_tracking = f"https://tuosito.com/track/{corriere}/{numero_tracking}"
response = requests.post(
"https://api.qr-verse.com/v1/qr-codes",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
},
json={
"type": "url",
"data": url_tracking,
"options": {
"size": 256,
"format": "svg",
"errorCorrection": "M"
}
}
)
return response.json()["image_url"]
Automazione Marketing
I team marketing hanno bisogno di codici QR in campagne email, landing page, direct mail e post sui social media. Un'integrazione API con la tua piattaforma di marketing significa che ogni risorsa della campagna ottiene automaticamente un codice QR tracciabile.
Piattaforme di email marketing (Mailchimp, SendGrid, personalizzate) - incorpora un codice QR univoco in ogni email che rimanda a una landing page personalizzata. Traccia quali destinatari hanno scansionato rispetto a chi ha cliccato. Questo è un segnale di attribuzione potente che la maggior parte dei marketer manca.
Builder di landing page - genera dinamicamente codici QR sulle landing page in modo che i visitatori possano passare dal desktop al mobile senza problemi. Il codice QR rimanda alla stessa pagina, pre-compilata con i dati di sessione del visitatore.
Automazione del direct mail - servizi come Lob e PostGrid possono includere codici QR generati via API in mailer stampati. Ogni pezzo ottiene un codice univoco per il tracciamento delle risposte.
Per l'attribuzione marketing, usa sempre codici QR dinamici con parametri UTM incorporati nell'URL di destinazione. Questo ti consente di vedere le scansioni dei codici QR insieme ad altre sorgenti di traffico in Google Analytics.
Sistemi Point of Sale e Retail
Il retail è uno dei punti di integrazione dei codici QR in più rapida crescita. I moderni sistemi POS usano codici QR per pagamenti contactless, ricevute digitali, programmi fedeltà e informazioni sui prodotti.
Ricevute digitali - invece di stampare una ricevuta cartacea, mostra un codice QR sullo schermo del terminale. Il cliente lo scansiona per ricevere la ricevuta sul telefono. Funziona per brand attenti alla sostenibilità e riduce i costi della carta.
Display prodotto - genera codici QR per etichette degli scaffali che rimandano a pagine prodotto dettagliate, recensioni e strumenti di confronto. Aggiorna l'URL di destinazione stagionalmente senza ristampare le etichette.
Programmi fedeltà - ogni cliente ottiene un codice QR persistente che il cassiere scansiona per applicare i punti. Lo stesso codice funziona in tutte le sedi.
Piattaforme di Gestione Eventi
Gli eventi generano enormi volumi di codici QR - uno per biglietto, per partecipante, per sessione. L'integrazione API è l'unico approccio pratico a questa scala.
Sistemi di biglietteria - genera un codice QR univoco per ogni biglietto venduto. Il codice codifica un ID biglietto che il tuo sistema di scansione all'ingresso convalida in tempo reale.
App per conferenze - badge partecipante con codici QR per il check-in alle sessioni, la scansione lead agli stand e il networking (scansiona il badge di qualcuno per scambiarsi i contatti).
Eventi virtuali e ibridi - codici QR sullo schermo durante le dirette streaming che rimandano a sondaggi, pagine Q&A o contenuti esclusivi.
Come Funzionano le API Codice QR
Se hai usato qualsiasi API REST, sai già come funzionano le API codice QR. Il flusso principale è diretto:
- Autenticati - includi la tua chiave API nell'intestazione della richiesta
- Invia una richiesta POST - specifica il tipo di codice QR, i dati del contenuto e le opzioni di design
- Ricevi la risposta - ottieni indietro un URL immagine, dati base64 o un file immagine binario
- Usa il codice QR - incorporalo nella tua app, email, PDF o layout stampato
Autenticazione
La maggior parte delle API codice QR usa uno dei due metodi di autenticazione:
| Metodo | Esempio | Ideale Per |
|---|---|---|
| Bearer token | Authorization: Bearer sk_live_abc123 | Chiamate server-to-server |
| Parametro chiave API | ?apikey=abc123 | Test rapido (non produzione) |
Usa sempre bearer token in produzione. I parametri chiave API appaiono nei log del server e nella cronologia degli URL.
Ciclo di Richiesta e Risposta
Una tipica richiesta di generazione codice QR si presenta così:
curl -X POST https://api.qr-verse.com/v1/qr-codes \
-H "Authorization: Bearer TUA_CHIAVE_API" \
-H "Content-Type: application/json" \
-d '{
"type": "url",
"data": "https://esempio.com/landing-page",
"options": {
"size": 512,
"format": "png",
"errorCorrection": "H",
"color": "#000000",
"backgroundColor": "#FFFFFF"
}
}'
La risposta include tipicamente:
{
"id": "qr_7f8a9b2c",
"type": "url",
"data": "https://esempio.com/landing-page",
"image_url": "https://cdn.qr-verse.com/qr/qr_7f8a9b2c.png",
"short_url": "https://qrv.se/abc123",
"created_at": "2026-02-16T10:30:00Z",
"scans": 0
}
Per i codici QR dinamici, il short_url è ciò che viene codificato nel pattern QR. Puoi aggiornare il campo data in seguito tramite una richiesta PUT e tutti i codici stampati esistenti reindirizzeranno alla nuova destinazione.
Esempi di Codice: Genera Codici QR Programmaticamente
Ecco esempi pronti per la produzione in quattro linguaggi. Ogni esempio mostra come creare un codice QR, gestire gli errori ed elaborare la risposta.
JavaScript / Node.js
async function creaQRCode(urlDestinazione, opzioni = {}) {
const response = await fetch('https://api.qr-verse.com/v1/qr-codes', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.QR_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
type: 'url',
data: urlDestinazione,
options: {
size: opzioni.size || 512,
format: opzioni.format || 'png',
errorCorrection: opzioni.errorCorrection || 'H',
...opzioni
}
})
})
if (!response.ok) {
const error = await response.json()
throw new Error(`Generazione QR fallita: ${error.message}`)
}
return response.json()
}
// Utilizzo
const qr = await creaQRCode('https://esempio.com/prodotto/123', {
size: 1024,
format: 'svg'
})
console.log(qr.image_url)
Python
import requests
import os
def crea_qr_code(url_destinazione, size=512, fmt="png", correzione_errori="H"):
"""Genera un codice QR tramite API."""
response = requests.post(
"https://api.qr-verse.com/v1/qr-codes",
headers={
"Authorization": f"Bearer {os.environ['QR_API_KEY']}",
"Content-Type": "application/json"
},
json={
"type": "url",
"data": url_destinazione,
"options": {
"size": size,
"format": fmt,
"errorCorrection": correzione_errori
}
}
)
response.raise_for_status()
return response.json()
# Crea un singolo codice QR
qr = crea_qr_code("https://esempio.com/evento/biglietto/456")
print(f"URL codice QR: {qr['image_url']}")
# Generazione bulk
prodotti = ["prod_001", "prod_002", "prod_003"]
for id_prodotto in prodotti:
qr = crea_qr_code(f"https://esempio.com/prodotti/{id_prodotto}")
print(f"{id_prodotto}: {qr['image_url']}")
cURL
# Generazione base codice QR
curl -X POST https://api.qr-verse.com/v1/qr-codes \
-H "Authorization: Bearer TUA_CHIAVE_API" \
-H "Content-Type: application/json" \
-d '{
"type": "url",
"data": "https://esempio.com",
"options": {
"size": 512,
"format": "png",
"errorCorrection": "H"
}
}'
# Genera un codice QR WiFi
curl -X POST https://api.qr-verse.com/v1/qr-codes \
-H "Authorization: Bearer TUA_CHIAVE_API" \
-H "Content-Type: application/json" \
-d '{
"type": "wifi",
"data": {
"ssid": "ReteOspiti",
"password": "benvenuto2024",
"encryption": "WPA2"
},
"options": {
"size": 512,
"format": "svg"
}
}'
# Aggiorna la destinazione di un codice QR dinamico
curl -X PUT https://api.qr-verse.com/v1/qr-codes/qr_7f8a9b2c \
-H "Authorization: Bearer TUA_CHIAVE_API" \
-H "Content-Type: application/json" \
-d '{
"data": "https://esempio.com/nuova-destinazione"
}'
PHP
function creaQRCode(string $url, array $opzioni = []): array
{
$payload = json_encode([
'type' => 'url',
'data' => $url,
'options' => array_merge([
'size' => 512,
'format' => 'png',
'errorCorrection' => 'H'
], $opzioni)
]);
$ch = curl_init('https://api.qr-verse.com/v1/qr-codes');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('QR_API_KEY'),
'Content-Type: application/json'
],
CURLOPT_POSTFIELDS => $payload
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode !== 200 && $httpCode !== 201) {
throw new RuntimeException("Generazione QR fallita: HTTP $httpCode");
}
return json_decode($response, true);
}
// Utilizzo
$qr = creaQRCode('https://esempio.com/fattura/789', ['format' => 'svg']);
echo $qr['image_url'];
Scelta di un'API Codice QR: Confronto Provider
Non tutte le API codice QR sono uguali. Ecco un confronto dei principali provider basato sulle funzionalità più importanti per gli sviluppatori.
| Funzionalità | QR-Verse | QR Server (goqr.me) | QR TIGER | Uniqode |
|---|---|---|---|---|
| Piano gratuito | Sì (web) | Sì (completamente gratuito) | No | No |
| Codici QR dinamici | Sì | No | Sì | Sì |
| Analytics scansioni | Sì | No | Sì | Sì |
| Branding personalizzato | Sì | No | Sì | Sì |
| Incorporamento logo | Sì | No | Sì | Sì |
| Arte QR con IA | Sì | No | No | No |
| Limite rate (gratuito) | Generoso | Illimitato | N/A | N/A |
| Formato risposta | PNG, SVG, PDF | PNG, SVG, EPS | PNG, SVG | PNG, SVG, PDF |
| Autenticazione | Bearer token | Nessuna | Chiave API | Chiave API |
| Webhook | In programma | No | No | Sì |
| Generazione bulk | Sì | No | Sì | Sì |
QR-Verse (Consigliato)
QR-Verse offre una piattaforma codice QR completa con un generatore web gratuito, codici QR dinamici, analytics delle scansioni e arte codice QR con IA. L'accesso API è disponibile nel livello Pro. Il vantaggio unico è la generazione di arte IA - puoi creare codici QR visivamente straordinari che fungono anche da arte del brand. Se stai già usando QR-Verse per la creazione manuale di codici QR, l'API è una naturale estensione.
QR Server (goqr.me)
L'opzione gratuita più semplice. Nessuna autenticazione richiesta - basta chiamare l'endpoint con i parametri query. Il problema: nessun codice QR dinamico, nessuna analytics, nessun branding. Ottimo per la prototipazione e gli strumenti interni dove il tracciamento non è importante.
QR TIGER
Un'API commerciale matura con buona documentazione. Parte da $7/mese per l'accesso API. Scelta solida per le aziende che necessitano di codici QR dinamici e analytics ma non necessitano di funzionalità arte IA.
Uniqode (precedentemente Beaconstac)
Focalizzato sulle grandi imprese con documentazione completa in sei lingue e supporto webhook. L'opzione più ricca di funzionalità per le grandi organizzazioni, ma i prezzi lo riflettono - è l'opzione più costosa in questa lista.
Se stai valutando i provider, inizia creando un codice QR gratuito su QR-Verse per testare la qualità dell'output. L'interfaccia web usa lo stesso motore dell'API, quindi quello che vedi è quello che ottieni programmaticamente.
Best Practice per l'Integrazione API Codice QR
Questi sono i pattern che separano le integrazioni di livello produzione dai prototipi fragili.
Livelli di Correzione degli Errori
I codici QR hanno quattro livelli di correzione degli errori che determinano quanta parte del codice può essere danneggiata (o oscurata da un logo) rimanendo scansionabile:
| Livello | Ripristino | Ideale Per |
|---|---|---|
| L (Basso) | 7% | Solo uso digitale, codici QR piccoli |
| M (Medio) | 15% | Uso generico, la maggior parte dei casi d'uso |
| Q (Quartile) | 25% | Segnaletica esterna, probabile usura |
| H (Alto) | 30% | Incorporamento logo, ambienti difficili |
Usa il livello H quando incorpori un logo - il logo copre parte del codice e hai bisogno della massima correzione degli errori per compensare. Per tutto il resto, il livello M è il punto ottimale tra densità dei dati e affidabilità.
Formati Immagine
- SVG - usa per la stampa. SVG è basato su vettori, quindi scala a qualsiasi dimensione senza pixelazione. Perfetto per cartelloni pubblicitari, poster e packaging.
- PNG - usa per il digitale. Siti web, email, app e dashboard. Scegli una dimensione di almeno 512x512px.
- PDF - usa quando consegni a un designer di stampa che ha bisogno di un file autonomo.
Incorporamento Logo Senza Compromettere la Scansionabilità
Quando incorpori un logo in un codice QR, stai letteralmente coprendo dei moduli dati. Segui queste regole:
- Mantieni il logo sotto il 30% dell'area del codice QR - più grande e anche la correzione degli errori di livello H potrebbe non salvarti
- Usa sempre il livello di correzione degli errori H quando aggiungi un logo
- Centra il logo - i marcatori di posizionamento del codice QR (i tre quadrati negli angoli) devono rimanere visibili
- Testa ogni codice - scansiona l'output finale con almeno tre telefoni diversi prima di inviarlo in produzione
Dinamico vs. Statico per l'Uso API
Per le integrazioni API, usa sempre codici QR dinamici per impostazione predefinita. Ecco perché:
- Puoi correggere gli errori senza ristampare
- Puoi fare A/B test sulle destinazioni
- Ottieni analytics delle scansioni per ogni codice
- Puoi scadere i codici dopo la fine di una campagna
- Puoi reindirizzare i codici a URL diversi in base alla posizione o al dispositivo
I codici statici sono appropriati solo quando hai bisogno della configurazione più semplice possibile (nessun account, nessun tracciamento) e l'URL di destinazione non cambierà mai. Scopri di più nel nostro confronto statico vs. dinamico.
Sicurezza: Proteggi le Tue Chiavi API
Questo è non negoziabile:
- Non esporre mai le chiavi API nel codice lato client. Non in JavaScript, non nei bundle di app mobile, non nelle variabili d'ambiente che vengono impacchettate nelle build frontend.
- Usa variabili d'ambiente sul tuo server. Accedivi tramite
process.env(Node.js),os.environ(Python) ogetenv()(PHP). - Ruota le chiavi se sospetti una perdita. La maggior parte dei provider ti consente di generare nuove chiavi istantaneamente.
- Usa chiavi con scope se il tuo provider le supporta - una chiave che può solo creare codici QR ma non eliminarli, per esempio.
Una chiave API esposta può consentire a un attaccante di generare codici QR che puntano a URL malevoli sotto il tuo account. Questo è un vettore di phishing - i codici QR sembrerebbero provenire dalla tua organizzazione. Leggi la nostra guida alla sicurezza dei codici QR per saperne di più su questa minaccia.
Limitazione del Rate e Caching
Ogni API ha limiti di rate. Ecco come lavorare entro di essi:
- Metti in cache le immagini dei codici QR - se stai mostrando lo stesso codice QR su una pagina prodotto che riceve 10.000 visualizzazioni al giorno, genera il codice una volta e metti in cache l'URL dell'immagine. Non rigenerare ad ogni caricamento di pagina.
- Usa un CDN - servi le immagini dei codici QR memorizzate nella cache da un CDN per una consegna globale veloce.
- Implementa l'exponential backoff - se raggiungi un limite di rate (HTTP 429), attendi e riprova con ritardi crescenti.
- Usa il batch dove possibile - se hai bisogno di 1.000 codici QR, usa l'endpoint di generazione bulk invece di 1.000 richieste individuali.
// Pattern di caching semplice con cache in memoria
const qrCache = new Map()
async function getOrCreateQR(url) {
const cacheKey = `qr:${url}`
if (qrCache.has(cacheKey)) {
return qrCache.get(cacheKey)
}
const qr = await creaQRCode(url)
qrCache.set(cacheKey, qr)
// Scade la cache dopo 24 ore
setTimeout(() => qrCache.delete(cacheKey), 86400000)
return qr
}
Casi d'Uso Avanzati
Una volta che hai l'integrazione API base funzionante, questi pattern avanzati sbloccano un significativo valore aziendale.
Generazione Bulk di Codici QR per il Packaging di Prodotti
Quando hai bisogno di migliaia di codici QR univoci - uno per ogni SKU prodotto, ogni numero seriale o ogni unità di packaging - la generazione bulk è essenziale.
Il pattern: prepara un file CSV o JSON con tutti i dati del prodotto, poi usa l'endpoint bulk per generare tutti i codici in una singola richiesta.
import requests
import os
def genera_bulk(prodotti):
"""Genera codici QR per un elenco di prodotti."""
items = [
{
"type": "url",
"data": f"https://tuosito.com/prodotti/{p['sku']}",
"label": p["nome"],
"options": {"size": 512, "format": "svg", "errorCorrection": "H"}
}
for p in prodotti
]
response = requests.post(
"https://api.qr-verse.com/v1/qr-codes/bulk",
headers={
"Authorization": f"Bearer {os.environ['QR_API_KEY']}",
"Content-Type": "application/json"
},
json={"items": items}
)
response.raise_for_status()
return response.json()["results"]
# Genera 500 codici QR prodotto
prodotti = [{"sku": f"SKU-{i:04d}", "nome": f"Prodotto {i}"} for i in range(500)]
risultati = genera_bulk(prodotti)
Codici QR Dinamici per i Biglietti degli Eventi
La biglietteria degli eventi è uno dei casi d'uso API più comuni. Ogni biglietto riceve un codice QR univoco che funge sia da pass di ingresso che da portatore di dati.
Il workflow:
- Il cliente acquista un biglietto
- Il tuo backend chiama l'API codice QR per generare un codice univoco
- Il codice codifica un URL di validazione:
https://eventi.tuosito.com/valida/ID-BIGLIETTO - Il codice è incorporato nell'email di conferma e aggiunto al portafoglio digitale del cliente
- All'ingresso, il personale scansiona il codice. Il tuo sistema lo convalida in tempo reale e lo contrassegna come utilizzato
Analytics delle Scansioni e Tracciamento dell'Attribuzione
Ogni scansione di un codice QR dinamico genera dati. L'API ti dà accesso a questi dati programmaticamente:
- Timestamp - quando è stato scansionato il codice?
- Posizione - città, paese e coordinate (basate sull'IP)
- Dispositivo - iOS, Android, modello, versione OS
- Referrer - dove era posizionato il codice QR?
Usa questi dati per l'attribuzione:
// Recupera analytics delle scansioni per un codice QR
const analytics = await fetch(
`https://api.qr-verse.com/v1/qr-codes/${qrId}/analytics?range=30d`,
{
headers: {
'Authorization': `Bearer ${process.env.QR_API_KEY}`
}
}
)
const data = await analytics.json()
console.log(`Scansioni totali: ${data.total_scans}`)
console.log(`Scanner unici: ${data.unique_scanners}`)
console.log(`Paese principale: ${data.top_countries[0].name}`)
Combina i dati di scansione QR con il tuo stack analytics esistente. Passa i parametri UTM nell'URL di destinazione e puoi tracciare l'intero percorso dalla scansione fisica alla conversione online.
Codici QR White-Label con Domini Personalizzati
Per agenzie e piattaforme SaaS che rivendono funzionalità di codice QR, il white-labeling è fondamentale. Invece di qrv.se/abc123, i tuoi codici QR si risolvono tramite qr.tuocliente.com/abc123.
I domini personalizzati:
- Costruiscono fiducia (gli utenti vedono un dominio familiare quando scansionano)
- Abilitano la coerenza del brand in tutti i punti di contatto
- Proteggono dal lock-in del provider (controlli il DNS)
QR-Verse supporta i domini personalizzati nei piani Business e superiori. Consulta i dettagli dei prezzi o iscriviti per un account gratuito per iniziare.
Inizia con QR-Verse
Non hai bisogno dell'accesso API per iniziare a generare codici QR. Il generatore di codice QR gratuito ti consente di creare codici QR dinamici, tracciare le scansioni, personalizzare i design e persino generare arte codice QR con IA - tutto tramite l'interfaccia web. Nessun account richiesto per i codici base.
Quando sei pronto a integrare la generazione di codice QR nelle tue applicazioni programmaticamente:
- Crea un account QR-Verse gratuito
- Genera i tuoi primi codici QR attraverso l'interfaccia web per testare la qualità
- Passa a Pro per l'accesso API e limiti di rate più elevati
- Usa gli esempi di codice in questa guida per costruire la tua integrazione
- Monitora le analytics delle scansioni attraverso il dashboard o l'API
Per domande sull'integrazione API, prezzi o requisiti personalizzati, contattaci. Se hai bisogno di accesso API con limiti generosi e generazione bulk, puoi passare a QR-Verse Pro direttamente dal tuo dashboard.
Domande Frequenti
L'API QR-Verse e gratuita?
QR-Verse offre la generazione gratuita di codici QR tramite l'interfaccia web. L'accesso API per la generazione programmatica fa parte del livello Pro. Puoi passare a QR-Verse Pro per sbloccare l'accesso API con limiti di rate generosi.
Quali formati restituisce l'API?
La maggior parte delle API codice QR restituisce immagini PNG per impostazione predefinita, con opzioni per SVG (scalabile, ideale per la stampa), PDF e dati codificati in base64. SVG e consigliato per qualsiasi codice QR che verra stampato in dimensioni variabili.
Posso generare codici QR dinamici tramite API?
Si. I codici QR dinamici sono il principale vantaggio di un'API - crei il codice una volta e aggiorni l'URL di destinazione in qualsiasi momento tramite una richiesta PUT. Il codice stampato non cambia mai. Per saperne di piu, leggi la nostra guida statico vs dinamico.
Qual e il limite di rate per le API codice QR?
I limiti di rate variano per provider e piano. I livelli gratuiti tipicamente consentono 50-100 richieste al giorno. I piani a pagamento vanno da 1.000 a illimitato. QR-Verse Pro offre limiti di rate generosi adatti alla maggior parte delle esigenze aziendali.
Posso aggiungere il mio logo ai codici QR generati via API?
Si. La maggior parte delle API codice QR moderne supporta l'incorporamento di logo. Carica la tua immagine logo e l'API la compone al centro del codice QR, usando il livello di correzione degli errori H per mantenere la scansionabilita.
Ho bisogno di un server backend per usare un'API codice QR?
Fortemente consigliato. Le chiavi API non dovrebbero mai essere esposte nel codice lato client. Usa il tuo server backend per proxy le richieste all'API codice QR, mantenendo sicure le tue credenziali. Leggi la nostra guida alla sicurezza QR per saperne di piu sulle best practice di sicurezza.
Posso tracciare le scansioni dai codici QR generati via API?
Si, se generi codici QR dinamici. Ogni scansione viene registrata con timestamp, posizione, tipo di dispositivo e dati del referrer. Accedi alle analytics tramite la stessa API o il tuo dashboard.
Quali linguaggi di programmazione sono supportati?
Funziona qualsiasi linguaggio in grado di effettuare richieste HTTP - JavaScript, Python, PHP, Ruby, Java, C#, Go e altro. Le API codice QR sono basate su REST, quindi non ci sono requisiti specifici per linguaggio.
Quanto e veloce la generazione di codice QR tramite API?
Tipicamente sotto i 200ms per un codice QR standard. Le personalizzazioni complesse (loghi, forme personalizzate) potrebbero richiedere leggermente piu tempo. Le operazioni bulk vengono solitamente elaborate in modo asincrono.
Posso generare codici QR per WiFi, vCard ed eventi tramite API?
Si. Le API codice QR supportano tutti i tipi standard - URL, testo, credenziali WiFi, vCard, eventi calendario, email, SMS, numeri di telefono e posizioni geografiche. QR-Verse supporta tutti questi sia tramite l'interfaccia web che tramite API.
Integra la Generazione di QR Code via API
Accedi all'API REST di QR-Verse per generare QR code dinamici su larga scala - con arte IA, analytics delle scansioni e supporto GS1 Digital Link. Inizia gratis, scala quando necessario.
Inizia Gratis →Pronto a creare il tuo QR code?
Piano gratuito disponibile. Nessuna iscrizione. Crea QR code professionali in pochi secondi.
Pronto a provarlo?
Crea codici QR professionali con tracciamento, colori personalizzati e arte IA.
Prova i nostri strumenti gratuiti:
Crea il tuo codice QR in pochi secondi
Nessuna registrazione, nessuna carta di credito. 25 tipi di QR con personalizzazione completa. Passa a Pro per potenza illimitata.
Condividi questo articolo
Articoli correlati

API QR code 2026 - Genera codici su larga scala
Hai bisogno di codici QR in grandi quantità? Questa guida mostra come chiamare un'API REST, gestire l'autenticazione e generare centinaia di codici automaticamente. Con esempi funzionanti.
Leggi di più
Viaggiare con i codici QR
Migliora il tuo modo di viaggiare. Dalle etichette bagaglio intelligenti agli itinerari digitali, scopri come i codici QR rendono i viaggi più sicuri e organizzati.
Leggi di più
Tendenze QR 2025: il futuro della tecnologia scansionabile
Codici arte IA, portali AR e streaming acquistabile. Esplora le 6 tendenze che definiscono la prossima generazione di tecnologia QR.
Leggi di più