§DEVELOPERS
Come integrare la generazione di QR nella tua app?
L'API REST di codigo-qr.es genera codici QR statici e dinamici, li gestisce e restituisce immagini PNG o SVG da qualunque linguaggio in una sola chiamata.
Richiede piano Pro
Posso usare l'API senza registrazione?
Si. L'endpoint pubblico genera codici QR statici senza account e senza API key, con un limite di 50 richieste al giorno per IP.
Usa POST /api/v1/qr/render con il contenuto del QR, il formato è la dimensione. Ricevi l'immagine in base64. Senza registrazione, senza carta di credito.
Esempio senza autenticazione
curl -X POST https://codigo-qr.es/api/v1/qr/render \
-H "Content-Type: application/json" \
-d '{"value":"https://yourdomain.com","format":"png","size":512}'Come funziona l'autenticazione dell'API?
L'API Pro usa API key nell'header Authorization. La key viene generata in /panel/account ed e esclusiva del piano Pro attivo.
Aggiungi l'header Authorization: Bearer con il tuo token a ogni richiesta Pro. La key viene generata con un clic in /panel/account e puo essere revocata in qualsiasi momento.
Esempio con API key
curl https://codigo-qr.es/api/v1/qr \
-H "Authorization: Bearer cqr_your_token_here"L'API key richiede un piano Pro attivo. Vedi piani e prezzi
Quali endpoint ha l'API per codici QR?
Otto endpoint: uno pubblico senza auth per la generazione immediata, e sette Pro per creare, elencare, aggiornare, eliminare, scaricare l'immagine e visualizzare le statistiche.
| Metodo | Percorso | Utilizzo | Plan |
|---|---|---|---|
| POST | /api/v1/qr/render | Genera un QR e restituisce l'immagine in base64. Senza auth. | Pubblico |
| GET | /api/v1/qr | Elenca tutti i tuoi codici QR con paginazione. | Pro |
| POST | /api/v1/qr | Crea un codice QR statico o dinamico. | Pro |
| GET | /api/v1/qr/{id} | Restituisce i dettagli completi di un codice QR. | Pro |
| PATCH | /api/v1/qr/{id} | Aggiorna destinazione, nome o stato. | Pro |
| DELETE | /api/v1/qr/{id} | Elimina un codice QR (eliminazione logica, reversibile). | Pro |
| GET | /api/v1/qr/{id}/image | Scarica l'immagine PNG o SVG del codice QR. | Pro |
| GET | /api/v1/qr/{id}/stats | Statistiche di scansione per giorno e paese. | Pro |
Per cosa viene usata l'API QR in un'azienda?
E-commerce, ristoranti, eventi e logistica la usano per generare QR automaticamente in documenti e sistemi senza intervento manuale.
E-commerce
L'ERP genera un QR per ogni documento di trasporto con il link di tracking. Se l'URL cambia, PATCH aggiorna la destinazione senza ristampare.
Ristoranti
La cassa crea un QR per ogni tavolo all'inizio del turno. Il cuoco aggiorna il menu nel CMS; il QR reindirizza sempre alla versione attuale.
Eventi
Il sistema di biglietteria genera un QR univoco per ogni biglietto. All'ingresso, lo scanner verifica il QR tramite l'API e ne conferma la validita.
Logistica
Ogni pacco ha un QR che punta alla sua pagina di tracking. Le scansioni vengono salvate in GET /api/v1/qr/{id}/stats.
Quante richieste permette l'API QR?
L'endpoint pubblico accetta 50 richieste al giorno per IP. Gli endpoint Pro permettono 60 richieste al minuto per utente con API key.
Se superi il limite, l'API restituisce 429 con gli header X-RateLimit-Limit, X-RateLimit-Remaining e Retry-After.
Pubblico
50
req / day / IP
Pro
60
req / min / user
Domande frequenti sull'API QR
L'endpoint pubblico e gratuito, limitato a 50 richieste al giorno per IP. L'API completa con API key, CRUD, immagine e statistiche richiede il piano Pro a 5,99€/mese.
PNG e SVG. Usa il parametro format=png o format=svg. Le dimensioni disponibili sono 256, 512 e 1024 pixel.
Si. PATCH /api/v1/qr/{id} aggiorna l'URL di destinazione in qualsiasi momento. Il codice QR stampato rimane uguale; cambia solo la destinazione.
Solo l'hash SHA-256 del token viene salvato, mai il token in chiaro. Viene mostrato una sola volta al momento della generazione. Puoi revocare la key in /panel/account.
Non ancora. L'API e REST standard e funziona con qualsiasi client HTTP: curl, fetch, axios, Python requests, PHP Guzzle e simili.
Inizia a integrare l'API QR oggi
Crea il tuo account, attiva il piano Pro e genera la tua prima API key in meno di 2 minuti.