API QR code per sviluppatori
L'accesso API è incluso nei piani Business e Agency.
Endpoint CRUD dell'API QR code
Elenchi e crei QR code su /api/v1/qrcodes; legga, aggiorni ed elimini un singolo codice su /api/v1/qrcodes/:id. Una modifica di destination_url o status via PATCH ha effetto dalla scansione successiva: il codice stampato non cambia mai.
Chiavi API con permessi definiti
Generi chiavi API dalla dashboard con i soli permessi necessari: qrcodes:read, qrcodes:write, scans:read, conversions:write. Ogni chiave è limitata a 300 richieste al minuto sulla REST API, più un limite separato di 300 al minuto sulle conversioni, ed è legata a un solo workspace. La conservi lato server.
Dati delle scansioni via API
Scorra gli eventi di scansione pagina per pagina su /api/v1/scans, filtrati per qr_id e per numero di giorni: dispositivo, paese, referrer e data e ora. Sono gli stessi dati dei grafici della dashboard, nel rispetto della privacy e senza alcun IP in chiaro.
API di conversione
Invii con POST gli eventi di acquisto e di registrazione a /api/v1/conversions con un event_name, un external_id per la deduplicazione, un importo e una valuta facoltativi e il qr_slug che ha portato il cliente, per attribuire i ricavi alla scansione.
Webhook
Registri i Suoi endpoint per ricevere gli eventi qr.scanned (ogni scansione reale, esclusi i bot) e qr.lead_captured (ogni contatto acquisito tramite modulo ospitato). Le consegne sono firmate con HMAC e, in caso di errore, ritentate con backoff.
Pixel JavaScript
Un pixel leggero (/pixel.js) invia le conversioni sul sito a /api/collect e le collega alla scansione QR che ha portato il visitatore tramite un riferimento di attribuzione di prima parte (il parametro qr_ref del link di destinazione, conservato nel localStorage del sito). Nessun fingerprinting: con Do Not Track attivo invia la conversione senza alcuna proprietà personalizzata, in linea con il modello di privacy della piattaforma, che non memorizza IP in chiaro.
Gli endpoint in pratica
Richieste JSON in entrata e in uscita, autenticate con chiave API Bearer.
curl -X POST https://qrcode-suite.com/api/v1/qrcodes \
-H "Authorization: Bearer $QRCS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "dynamic_url",
"name": "Spring packaging insert",
"destination_url": "https://example.com/spring-landing"
}'# Re-point a printed code — no reprint needed
curl -X PATCH https://qrcode-suite.com/api/v1/qrcodes/$QR_ID \
-H "Authorization: Bearer $QRCS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "destination_url": "https://example.com/summer-landing" }'curl -X POST https://qrcode-suite.com/api/v1/conversions \
-H "Authorization: Bearer $QRCS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"event_name": "purchase",
"external_id": "order-1042",
"amount": 49.90,
"currency": "EUR",
"qr_slug": "k7Qm2x"
}'Generi l'immagine in PNG o SVG
GET /api/qr/:slug restituisce l'immagine scansionabile di un codice che ha creato: ?format=png o ?format=svg, e ?size= in pixel (400 di default). Per la stampa, ?dpi= (150, 300, 600 o 1200) insieme a ?mm= produce un file largo fisicamente quei millimetri, con la densità scritta nel PNG così che il software di impaginazione lo posizioni alla misura giusta. L'estensione del file segue ciò che è stato effettivamente generato: un design che il rendering raster non riesce ad appiattire viene restituito in SVG, e lo dichiara. L'endpoint non richiede chiave API — l'immagine non rivela nulla oltre allo slug già stampato sul codice — ed è limitato per IP in hash. Genera solo codici esistenti in un workspace: non è un generatore anonimo.
# Screen image — no API key needed
curl -o insert.png "https://qrcode-suite.com/api/qr/k7Qm2x?format=png&size=600"
# Print file: 25 mm wide at 300 DPI
curl -o insert-print.png "https://qrcode-suite.com/api/qr/k7Qm2x?format=png&dpi=300&mm=25"Usa il plugin WordPress?
Il plugin WordPress ha le sue route REST sul Suo sito, sotto /wp-json/qrcode-suite/v1/, autenticate con chiavi create nell'amministrazione del plugin (Authorization: Bearer o X-API-Key). Aggiunge anche il comando WP-CLI wp qrcs con create, scan-stats, bulk-export, webhook-test e label-generate. Queste route agiscono sui codici salvati in WordPress; l'API della piattaforma qui sopra agisce sul Suo workspace. Collegando il sito alla piattaforma (su attivazione) codici, totali giornalieri delle scansioni e conversioni WooCommerce compaiono nella Sua dashboard.
Domande frequenti
Che cos'è QRCode Suite?
QRCode Suite è una piattaforma QR indipendente: crei un account gratuito e generi QR code dinamici e personalizzati nel browser — senza bisogno di WordPress. I connettori portano gli stessi codici su WordPress e WooCommerce, dove gli ordini possono essere attribuiti a specifici QR code.
QRCode Suite funziona senza WordPress?
Sì. QRCode Suite è un SaaS indipendente: si registri, crei i QR code e monitori le scansioni interamente su qrcode-suite.com. Il plugin WordPress è un connettore opzionale che porta i Suoi codici in wp-admin e aggiunge l'attribuzione degli ordini WooCommerce.
QRCode Suite richiede un abbonamento separato?
Il piano Free è disponibile senza costi — senza carta di credito. I piani a pagamento (Pro 9 €, Business 29 €, Agency 79 € al mese) sbloccano codici illimitati, regole di redirect e altro. Non ci sono costi per singola scansione.
Quali tipi di QR code supporta QRCode Suite?
QRCode Suite supporta 22 tipi di QR code: URL statico, URL dinamico, Testo semplice, Telefono, Email, Posizione, Link Hub, SMS, WhatsApp, Wi-Fi, vCard, Profilo social, PDF, Download di file, Download di app, Coupon, Evento calendario, Modulo di raccolta lead, Raccolta recensioni, Richiesta all'ingrosso, Premio fedeltà e Payload personalizzato.
Posso modificare la destinazione di un QR code dopo averlo stampato?
Sì. I QR code dinamici usano un URL di redirect breve. Può aggiornare la destinazione dalla dashboard in qualsiasi momento, senza rigenerare o ristampare il codice.
QRCode Suite è conforme al GDPR?
QRCode Suite è progettato nel rispetto del GDPR: gli indirizzi IP in chiaro non vengono mai memorizzati — i visitatori sono conteggiati con hash a chiave —, il traffico dei bot viene filtrato automaticamente e gli eventi di scansione vengono eliminati allo scadere della finestra di conservazione del suo piano. Consulti il suo team legale per gli obblighi specifici.
Costruisca sulla QRCode Suite API
Chiavi API con scope ed endpoint REST — inclusi da Business.