Documentazione

API pubblica justQRs

Gestisci i tuoi codici QR in modo programmatico. Crea una chiave API da Chiavi API nella dashboard (solo titolari dell'account).

URL di base

https://api.justqrs.com

Autenticazione

Invia la tua chiave API come bearer token in ogni richiesta:

Authorization: Bearer jqr_xxxxxxxxxxxxxxxx

Le chiavi vengono mostrate per intero una sola volta, al momento della creazione. Per ruotare una chiave, creane una nuova ed elimina quella vecchia.

Endpoint

Metodo	Percorso	Descrizione
GET	`/v1/qrcodes`	Elenca i tuoi codici QR. Response: { qrcodes: QrResponse[] }
POST	`/v1/qrcodes`	Crea un codice QR. Request: CreateQrRequest { name, mode, content, design? } · Response: QrResponse
GET	`/v1/qrcodes/{qrId}`	Recupera un singolo codice QR. Response: QrResponse
PATCH	`/v1/qrcodes/{qrId}`	Aggiorna un codice QR (solo codici dinamici). Request: UpdateQrRequest { name?, content?, design? } · Response: QrResponse
DELETE	`/v1/qrcodes/{qrId}`	Elimina un codice QR. Response: 204 No Content
GET	`/v1/qrcodes/{qrId}/stats?days=7\|30\|90`	Statistiche di scansione di un codice QR dinamico. Response: QrStats { totalScans, rangeScans, rangeUniques, series, breakdowns }

Esempio: creare un codice QR per un URL

curl -X POST "https://api.justqrs.com/v1/qrcodes" \
  -H "Authorization: Bearer jqr_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My link",
    "mode": "dynamic",
    "content": { "kind": "url", "url": "https://example.com" }
  }'

Esempio: recuperare le statistiche di scansione

curl "https://api.justqrs.com/v1/qrcodes/{qrId}/stats?days=30" \
  -H "Authorization: Bearer jqr_xxxxxxxxxxxxxxxx"

Errori

Le risposte di errore sono in JSON: { "error": string, "code"?: string }.

Stato	Codice	Significato
400	`(validation)`	Il corpo della richiesta non ha superato la validazione: consulta il messaggio di errore per i dettagli.
401	`—`	Header Authorization mancante.
403	`—`	Chiave API rifiutata: non valida, revocata o scaduta.
402	`upgrade_required`	Il tuo account è sul piano gratuito: l'accesso all'API richiede un piano a pagamento.
404	`—`	Il codice QR non esiste o non appartiene a questo account.
409	`qr_limit_reached`	L'account ha già raggiunto il limite di codici QR dinamici (500 nel piano base, altri disponibili con i pacchetti aggiuntivi).