Guida rapida all'API QR Code

L'API di QR Code Genius ti consente di generare codici QR in modo programmatico: immagini PNG completamente personalizzate, batch in blocco con tracciamento delle scansioni e immagini leggere da incorporare direttamente in una pagina web o in un'email.

Crea una API key

1. Accedi e apri la Dashboard sviluppatori.
2. Fai clic su Crea API Key e assegnale un nome.
3. Copia subito la chiave: viene mostrata una sola volta. Sui nostri server viene salvato solo un hash sicuro, quindi una chiave persa deve essere revocata e sostituita.

Le chiavi hanno questo aspetto:

qrc_9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c...

URL di base

https://www.qrcodegenius.com/api/v1

La tua prima richiesta

Passa la chiave nell'header Authorization e invia in POST il contenuto da codificare:

curl -X POST https://www.qrcodegenius.com/api/v1/qr \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "data": "https://example.com", "width": 512, "height": 512 }'

La risposta contiene il codice QR come data URL PNG in base64, insieme al tuo utilizzo attuale:

{
  "success": true,
  "data": "data:image/png;base64,iVBORw0KGgo...",
  "meta": { "usage_count": 1, "remaining": 49, "strategy": "monthly" }
}

Endpoint

• POST /qr — genera un singolo codice QR completamente personalizzato. Vedi Generare un codice QR.
• POST /qr/bulk — genera fino a 100 codici QR in una sola chiamata e li salva nel tuo account, opzionalmente come codici dinamici tracciabili (piano Pro). Vedi Generazione QR in blocco.
• GET /render — un PNG veloce e memorizzabile in cache da usare direttamente in un tag img. Vedi Incorporare un'immagine QR.

Piani e limiti

• Free: 50 richieste API al mese.
• Pro: 1.000 richieste API al mese, oltre all'accesso alla generazione in blocco.
• I crediti acquistati vengono utilizzati automaticamente una volta esaurita la quota mensile.

Vedi Errori e limiti di velocità per i dettagli su quote e gestione degli errori.