QRCode Suitepiattaforma QR
Sviluppatori

API QR code per sviluppatori

QRCode Suite espone una REST API versionata sulla piattaforma: crei QR code, cambi le destinazioni e legga le analytics di scansione con lo stesso motore della dashboard. L'autenticazione usa chiavi API con scope create dalla dashboard. Un endpoint di conversione, webhook firmati HMAC e un pixel JavaScript sono in arrivo insieme al reporting delle conversioni.

L'accesso API è incluso nei piani Business e Agency.

Inizia gratis Vedi i prezzi

QR code CRUD endpoints

List, create, update, archive, and duplicate QR codes under /api/v1/qrcodes. Changing a destination via PATCH takes effect on the very next scan — the printed code never changes.

Scoped API keys

Mint API keys from the dashboard with read-only or read-write scopes and per-key rate limits. Keys are workspace-bound; keep them server-side, never in browser code.

Scan analytics over the API

Pull scans, devices, countries, referrers, and unique-visitor counts per code from /api/v1/qrcodes/:id/analytics — the same privacy-first data the dashboard charts, with no raw IPs anywhere.

Conversion API (rolling out)

POST purchase and signup events to /api/v1/events/conversion to attribute revenue back to the scan that produced it. Rolling out together with campaign ROI reporting.

Webhooks (rolling out)

Subscribe endpoints to scan and conversion events. Deliveries are HMAC-signed so your handler can verify authenticity, with retry-and-backoff on transient failures.

JavaScript pixel (rolling out)

A lightweight, consent-aware pixel links on-site conversions to prior QR scans without cookies or fingerprinting — designed to match the platform’s no-raw-IP privacy model.

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": "https://example.com/spring-landing"
  }'
# Re-point a printed code — no reprint needed
curl -X PATCH https://qrcode-suite.com/api/v1/qrcodes/qr_8f3k2 \
  -H "Authorization: Bearer $QRCS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "destination": "https://example.com/summer-landing" }'
# Conversion API (rolling out)
curl -X POST https://qrcode-suite.com/api/v1/events/conversion \
  -H "Authorization: Bearer $QRCS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": "1042",
    "value": 49.90,
    "currency": "EUR"
  }'

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.

Vedi il piano BusinessLeggi la documentazione