Vada al contenuto principale
REST API

Generi QR Code su Larga Scala con la Nostra API REST

Integri creazione, gestione e analisi dei codici QR in qualsiasi applicazione. API JSON RESTful con autenticazione tramite chiave API, esportazione ZIP in blocco e webhook in tempo reale.

POST /api/v1/qr-codes
{ "type": "url", "data": "https://example.com" }

L'API REST di QR-Verse consente agli sviluppatori di creare, gestire e tracciare codici QR in modo programmatico. Esporti fino a 50 codici esistenti come file ZIP tramite l'endpoint di esportazione in blocco, riceva notifiche di scansione in tempo reale tramite webhook e acceda ad analytics dettagliate. Si autentichi con una semplice chiave API e inizi l'integrazione in pochi minuti con qualsiasi client HTTP.

Crei un QR code in pochi secondi

Basta una sola richiesta POST. Invii i Suoi dati e ottenga un QR code scansionabile con un URL breve monitorabile e un'immagine scaricabile.

Richiesta
cURL
curl -X POST \
https://qr-verse.com/api/v1/qr-codes \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Spring campaign",
"destination_url": "https://example.com"
}'
Risposta
201 Created
{
"data": {
"id": "qr_abc123",
"name": "Spring campaign",
"qr_type": "url",
"destination_url": "https://example.com",
"is_active": true,
"redirect_slug": "abc123",
"tags": [],
"created_at": "2026-10-09T12:00:00Z"
}
}

Tutto ciò che Le serve per sviluppare

Un'API completa per la gestione del ciclo di vita dei codici QR. Dalla creazione e personalizzazione al monitoraggio delle scansioni e alle notifiche in tempo reale.

Operazioni CRUD complete

Crei, legga, aggiorni ed elimina codici QR in modo programmatico. Tutti i tipi QR supportati: URL, vCard, WiFi, email, SMS e altro.

Esportazione ZIP in blocco

Esporti fino a 50 codici QR esistenti come file ZIP in una singola richiesta API. Download in PNG o SVG con lo stile originale preservato.

API Analytics

Recuperi i dati di scansione in modo programmatico. Totali di un periodo e un record per scansione: ora, paese, città, tipo di dispositivo, sistema operativo, browser e parametri UTM.

Eventi webhook

Riceva notifiche HTTP in tempo reale quando i Suoi codici QR vengono scansionati. Attivi flussi di lavoro nel Suo CRM, analytics o strumenti di automazione.

Gestione chiavi API

Generi, ruoti e revochi le chiavi API dalla Sua dashboard. I piani Pro e Business supportano chiavi multiple per ambienti diversi.

Rate limiting

La creazione di codici QR tramite API è limitata a 30 richieste ogni 60 secondi per chiave API. Oltre tale limite l'API risponde con lo stato 429.

Accesso API per piano

L'accesso API parte da Pro. Business aggiunge l'importazione massiva da un file CSV nell'interfaccia web e limiti più alti per webhook e chiavi API per ambienti di team.

Funzionalità
Gratuito
EUR 0/mese
Pro
4,99 €/mese
Business
12,99 €/mese
Accesso API REST
Gestione chiavi API
Crei / Leggi / Aggiorna / Elimina
Codici QR dinamici da un URL di destinazione
Recupero dati analytics
Limite di velocità (creazione codici)030 / min30 / min
Esportazione ZIP in blocco (fino a 50 codici)
Notifiche webhook
Chiavi API multiple

Progettato per il Suo stack

Che Lei gestisca un negozio online, pipeline di vendita o campagne marketing automatizzate, l'API QR-Verse si adatta perfettamente al Suo flusso di lavoro esistente.

Piattaforme e-commerce

Generi automaticamente QR code per ogni prodotto nel Suo catalogo. Colleghi alle pagine prodotto, aggiungili al packaging o incorporali nelle ricevute. Esporti i codici esistenti come file ZIP tramite API per i flussi di lavoro di stampa e packaging.

Shopify, WooCommerce o storefront personalizzati

CRM e strumenti di vendita

Crei QR code personalizzati per materiali di vendita, biglietti da visita o portali clienti. Usi i webhook per registrare le scansioni come attività CRM e monitorare il coinvolgimento per contatto.

HubSpot, Salesforce, Pipedrive

Marketing automation

Incorpori QR code dinamici in campagne email, annunci stampati o materiali per eventi. Recuperi le analytics di scansione tramite API per misurare il ROI delle campagne insieme ai dati di marketing esistenti.

Mailchimp, ActiveCampaign, Zapier

Esperienza per sviluppatori

Creata da sviluppatori, per sviluppatori. Risposte prevedibili, documentazione chiara e versioning stabile per rilasciare con fiducia.

Chiavi API con scope

Assegni a ogni chiave solo i permessi di cui ha bisogno: qr:read, qr:write, qr:create e analytics:read. Una chiave priva dello scope di un endpoint riceve un 403, e un token di sessione di un utente connesso non è accettato dall'API.

Risposte JSON

Risposte JSON pulite e coerenti con struttura prevedibile. Ogni endpoint restituisce lo stesso formato: oggetti dati, paginazione ed errori su cui può fare affidamento.

Gestione degli errori

Risposte di errore strutturate con codici di stato HTTP, codici di errore leggibili dalla macchina e messaggi comprensibili. Risolva i problemi rapidamente senza dover fare congetture.

Versioning API

Endpoint API con versioning (v1) e garanzie di compatibilità con le versioni precedenti. Le modifiche incompatibili vengono rilasciate solo in nuove versioni principali, per mantenere stabile la Sua integrazione.

Endpoint disponibili
GET/api/v1/qr-codes
POST/api/v1/qr-codes
GET/api/v1/qr-codes/:id
PATCH/api/v1/qr-codes/:id
DELETE/api/v1/qr-codes/:id
GET/api/v1/qr-codes/:id/scans

Domande frequenti

Quale metodo di autenticazione usa l'API QR-Verse?
L'API usa l'autenticazione tramite chiave API con Bearer token. Includa la Sua chiave API nell'header Authorization come "Bearer SUA_CHIAVE_API". Può generare e gestire le chiavi API dalla Sua dashboard.
Quali tipi di codice QR posso creare tramite API?
L'API crea codici QR dinamici che reindirizzano a un URL di destinazione: invii un name e una destination_url a POST /api/v1/qr-codes. Il campo type è un'etichetta (url, link, text, email, wifi, vcard, sms, phone, geo, event, crypto o social) e il contenuto è sempre l'URL. I codici con dati propri, come una vCard o una rete WiFi, si creano nell'app web.
Come funziona l'esportazione ZIP in blocco?
Gli utenti dei piani Pro e Business possono esportare fino a 50 codici QR esistenti come file ZIP tramite POST /api/qr/bulk-export, con una sessione o una chiave API con lo scope qr:read. Specifichi gli ID dei codici da esportare e scelga il formato PNG o SVG. L'API restituisce uno ZIP contenente ogni codice come file separato con lo stile originale preservato.
Cosa succede quando raggiungo il rate limit?
La creazione di un codice (POST /api/v1/qr-codes) è limitata a 30 richieste per finestra di 60 secondi per chiave API. Oltre tale limite l'API risponde con lo stato 429 e il messaggio "Rate limit exceeded". Le risposte non contengono header di rate limit né un orario di reset: attenda un minuto e riprovi.
Posso personalizzare l'aspetto dei codici QR tramite API?
Non tramite l'API v1. Un codice creato tramite API parte con lo stile predefinito (nero su bianco); in seguito può personalizzarlo nell'app web. Colori, correzione degli errori e formato di output non sono parametri di POST /api/v1/qr-codes.
Come funzionano i webhook per gli eventi di scansione?
Gli utenti dei piani Pro e Business possono registrare URL webhook dalla dashboard. Quando uno dei Suoi codici QR viene scansionato, inviamo una richiesta POST all'URL webhook con i dettagli della scansione: l'evento e un timestamp, più ID e nome del codice QR, paese e città, tipo di dispositivo, sistema operativo, browser, se la scansione è unica e i parametri UTM (nessun referrer). I webhook usano firme HMAC per la verifica.
L'API è disponibile nel piano gratuito?
No. L'accesso API richiede un piano Pro (4,99 €/mese) o Business (12,99 €/mese). Il piano gratuito include il generatore QR basato sul web ma non l'accesso programmatico all'API.
Posso recuperare i dati analytics tramite API?
Sì. I piani Pro e Business includono l'accesso API alle analytics di scansione, con una chiave che abbia lo scope analytics:read. GET /api/v1/qr-codes/:id/scans restituisce le scansioni di un codice QR pagina per pagina (ora, paese, città, tipo di dispositivo, sistema operativo, browser, unica o no, parametri UTM) e un riepilogo con il totale delle scansioni, le scansioni e le scansioni uniche del periodo e la durata del periodo. Non restituisce una ripartizione per giorno, settimana o mese né il referrer: aggreghi i record dalla Sua parte.

Integrare i codici QR nel Suo flusso di lavoro

L'API REST di QR-Verse Le permette di generare, gestire e recuperare analisi delle scansioni per i QR code in modo programmatico. Ogni operazione disponibile nella dashboard è accessibile via API, il che significa che il Suo team di sviluppo può integrare la generazione di QR code direttamente in strumenti interni, piattaforme e-commerce, pipeline di fulfillment o prodotti SaaS senza passaggi manuali.

I pattern di integrazione comuni includono la generazione programmatica - creando QR code unici, una richiesta alla volta, ognuno con un URL di destinazione distinto e metadati personalizzati opzionali. Ideale per la serializzazione dei prodotti, sistemi di biglietteria o programmi di carte fedeltà. L'API restituisce ogni codice generato come SVG o PNG nel corpo della risposta.

L'endpoint di analisi delle scansioni fornisce accesso in tempo reale agli stessi dati visibili nella dashboard - scansioni totali, scansioni uniche, distribuzione geografica, distribuzione per dispositivo e dati di serie temporali - tutto in JSON strutturato. Può quindi inviare gli eventi di scansione QR direttamente al Suo data warehouse, CRM o strumento di reporting. Il supporto webhook è disponibile nei livelli Pro e Business.

L'API è piccola di proposito: sei endpoint sotto /api/v1, JSON in ingresso e in uscita e una chiave API con scope per l'accesso. Gli endpoint sono elencati in questa pagina e l'esempio qui sotto mostra una richiesta e la sua risposta. Non ci sono pacchetti SDK né documentazione interattiva ospitata: basta un semplice client HTTP come cURL o fetch.

Piano Pro richiesto

Ottenga la Sua chiave API

Si registri a un piano Pro o Business, generi la Sua chiave API dalla dashboard e inizi a fare richieste in pochi minuti.

Inizi a sviluppare