Quickstart API REST
- 1
Crei una chiave API
Nell'admin WordPress: QR Suite → Chiavi API → Crea. Nomini la chiave, scelga uno scope (`read`, `read-write` o `admin`), copi il secret subito — viene mostrato una sola volta. Formato: `qcs_live_<32-hex>`. Lo memorizzi nel Suo env come `QCS_API_KEY`.
- 2
Crei un QR dinamico
POST su `/wp-json/meliqs/v1/qrs` con header `Authorization: Bearer $QCS_API_KEY` e body `{"type": "url", "target": "https://example.com/landing", "name": "test API"}`. Restituisce l'id del QR, l'URL breve codificata, i metadati. Salvi l'id per le due chiamate successive.
- 3
Recuperi gli analytics
GET `/wp-json/meliqs/v1/qrs/{id}/scans?from=2026-01-01&to=2026-05-01` restituisce eventi paginati: IP hashato, paese, dispositivo, referrer, UTM. Pagina di default 100; `page=2&per_page=200` per query più grandi fino a 1000 per pagina.
- 4
Aggiorni la destinazione
PATCH `/wp-json/meliqs/v1/qrs/{id}` con body `{"target": "https://example.com/new-destination"}`. Restituisce 200 con il record aggiornato. Il QR stampato risolve subito al nuovo URL — senza ristampa, senza purge cache.
- 5
Webhook per scan in tempo reale
Abboni un URL webhook per ricevere ogni evento: POST su `/wp-json/meliqs/v1/webhooks` con body `{"url": "https://il-suo-server.example/scan-hook", "events": ["scan.created"]}`. Ogni scan ora innesca un POST firmato HMAC verso il Suo endpoint entro 200 ms.
Domande frequenti
Che cos'è QRCode Suite?
QRCode Suite è un plugin WordPress premium che genera QR code dinamici e personalizzati direttamente dalla Sua dashboard WordPress. I dati di scansione sono memorizzati sul Suo server — non su una piattaforma SaaS di terzi — e gli ordini WooCommerce possono essere attribuiti a specifici QR code.
QRCode Suite richiede un abbonamento separato?
Il piano Free è disponibile senza costi. I piani a pagamento (Pro, Business, Agency) sono licenziati per sito WordPress e fatturati mensilmente o annualmente. Non ci sono costi per singola scansione.
Quali tipi di QR code supporta QRCode Suite?
QRCode Suite supporta 15 tipi di QR code: URL, vCard, Wi-Fi, SMS, Email, WhatsApp, PDF, Coupon, Testo semplice, Profilo social, Prodotto WooCommerce, Riordino WooCommerce, Link Hub, Telefono e URL dinamico.
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 WordPress in qualsiasi momento, senza rigenerare o ristampare il codice.
QRCode Suite è conforme al GDPR?
Sì. QRCode Suite esegue l'hashing degli indirizzi IP con SHA-256 prima dell'archiviazione: nessun IP in chiaro viene mai salvato. Filtra automaticamente il traffico dei bot e include impostazioni di conservazione dati configurabili.
Serve aiuto per iniziare?
Scarichi il plugin gratuito o consulti tutta la documentazione.