QR-Verse
REST API

API Codice QR per Sviluppatori

Integra creazione, gestione e analisi dei codici QR in qualsiasi applicazione. API JSON RESTful con autenticazione tramite chiave API, operazioni in massa e webhook in tempo reale. Da un singolo codice a 500 per richiesta.

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

Crea un QR code in pochi secondi

Basta una sola richiesta POST. Invia i tuoi dati e ottieni 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 '{
"type": "url",
"data": "https://example.com",
"style": { "foreground": "#238636" }
}'
Risposta
201 Created
{
"id": "qr_abc123",
"type": "url",
"shortUrl": "https://qr-verse.com/r/abc123",
"image": "https://qr-verse.com/api/v1/qr-codes/qr_abc123/image.svg"
}

Tutto ciò che ti 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

Crea, leggi, aggiorna ed elimina codici QR in modo programmatico. Tutti i tipi QR supportati: URL, vCard, WiFi, email, SMS e altro.

Operazioni in blocco

Crea fino a 500 codici QR in una singola richiesta API. Ideale per cataloghi e-commerce, biglietti per eventi o gestione dell'inventario.

API Analytics

Recupera i dati di scansione in modo programmatico. Scansioni totali, scansioni nel tempo, ripartizione geografica, tipi di dispositivo e dati referrer.

Eventi webhook

Ricevi notifiche HTTP in tempo reale quando i tuoi codici QR vengono scansionati. Attiva flussi di lavoro nel tuo CRM, analytics o strumenti di automazione.

Gestione chiavi API

Genera, ruota e revoca le chiavi API dalla tua dashboard. I piani Business supportano chiavi multiple per ambienti diversi.

Rate limiting

Header di rate limit chiari in ogni risposta. Pro: 100 chiamate/giorno. Business: 10.000 chiamate/giorno. Non dovrai mai indovinare la quota rimanente.

Accesso API per piano

L'accesso API parte da Pro. Business sblocca le operazioni in blocco, i webhook e 100 volte il limite giornaliero di chiamate.

Funzionalità
Free
EUR 0
Pro
EUR 4.99/mo
Business
EUR 12.99/mo
Accesso API REST
Gestione chiavi API
Crea / Leggi / Aggiorna / Elimina
Tutti i tipi QR (URL, vCard, WiFi...)
Recupero dati analytics
Chiamate API al giorno010010.000
Operazioni in blocco (per richiesta)Fino a 500
Notifiche webhook
Chiavi API multiple
Risposte API white-label
Documentazione OpenAPI / Swagger
Inizia con ProConfronta tutti i piani

Progettato per il tuo stack

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

Piattaforme e-commerce

Genera automaticamente QR code per ogni prodotto nel tuo catalogo. Collega alle pagine prodotto, aggiungili al packaging o incorporali nelle ricevute. Crea in blocco 500 codici per chiamata API per grandi inventari.

Shopify, WooCommerce o storefront personalizzati

CRM e strumenti di vendita

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

HubSpot, Salesforce, Pipedrive

Marketing automation

Incorpora QR code dinamici in campagne email, annunci stampati o materiali per eventi. Recupera 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.

Documentazione OpenAPI

Specifica OpenAPI 3.0 completa con Swagger UI interattivo. Testa gli endpoint direttamente dalla documentazione. Ogni schema di richiesta e risposta è documentato.

Risposte JSON

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

Gestione degli errori

Risposte di errore strutturate con codici di stato HTTP, codici di errore leggibili dalla macchina e messaggi comprensibili. Risolvi 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 tua integrazione.

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

Domande frequenti

Quale metodo di autenticazione usa l'API QR-Verse?
L'API usa l'autenticazione tramite chiave API con Bearer token. Includi la tua chiave API nell'header Authorization come "Bearer TUA_CHIAVE_API". Puoi generare e gestire le chiavi API dalla tua dashboard.
Quali tipi di codice QR posso creare tramite API?
Tutti i tipi di codice QR disponibili nell'interfaccia web sono disponibili anche via API: URL, vCard (biglietti da visita), credenziali di rete WiFi, email, SMS, testo semplice e altro. Ogni tipo ha il proprio schema dati documentato nella specifica OpenAPI.
Come funziona la creazione di codici QR in blocco?
Gli utenti del piano Business possono inviare un array di fino a 500 oggetti codice QR in una singola richiesta POST all'endpoint bulk. Ogni codice può avere tipi, dati e stili diversi. L'API restituisce tutti i codici creati con i loro ID e URL brevi.
Cosa succede quando raggiungo il rate limit?
Ogni risposta API include header di rate limit: X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Quando superi il limite, l'API restituisce un codice di stato 429 con il timestamp di reset. I piani Pro ottengono 100 chiamate/giorno, i piani Business 10.000.
Posso personalizzare l'aspetto dei codici QR tramite API?
Sì. L'API accetta parametri di stile tra cui colore primo piano, colore sfondo, livello di correzione degli errori e formato di output (SVG o PNG). Le stesse opzioni di personalizzazione disponibili nel generatore web sono disponibili tramite API.
Come funzionano i webhook per gli eventi di scansione?
Gli utenti del piano Business possono registrare URL webhook dalla dashboard. Quando uno dei tuoi codici QR viene scansionato, inviamo una richiesta POST all'URL webhook con i dettagli della scansione: ID codice QR, timestamp, posizione (paese/città), tipo di dispositivo e referrer. I webhook usano firme HMAC per la verifica.
L'API è disponibile nel piano gratuito?
No. L'accesso API richiede un piano Pro (EUR 4,99/mese) o Business (EUR 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 accesso API alle analytics di scansione. Puoi recuperare il conteggio totale delle scansioni, le scansioni nel tempo (giornaliero/settimanale/mensile), la ripartizione geografica per paese e città, i tipi di dispositivo e i principali referrer per qualsiasi codice QR.
Piano Pro richiesto

Ottieni la tua chiave API

Registrati a un piano Pro o Business, genera la tua chiave API dalla dashboard e inizia a fare richieste in pochi minuti. Documentazione OpenAPI completa inclusa.

Inizia a sviluppare