Per sviluppatori

API per QR Code

Genera QR code e leggi le analisi delle scansioni direttamente dal tuo codice. L'API di CodesQR è un'interfaccia REST piccola e prevedibile che restituisce JSON, disponibile su ogni account CodesQR.

Ottieni la tua chiave API Guarda un esempio

Autenticazione

Ogni richiesta è autenticata con una chiave API segreta inviata come bearer token. Crea una chiave dalla tua dashboard sotto Impostazioni, tienila lato server e non esporla mai nel codice client. Tutte le richieste passano su HTTPS verso https://api.codesqr.com.

Authorization: Bearer sk_live_your_api_key

Endpoint

POST /v1/qr

Crea un QR code statico o dinamico.

GET /v1/qr/{id}

Recupera un singolo QR code e gli URL delle sue immagini.

PATCH /v1/qr/{id}

Cambia la destinazione o il titolo di un codice dinamico.

GET /v1/qr/{id}/stats

Leggi le analisi delle scansioni per un codice dinamico.

GET /v1/qr

Elenca i QR code nel tuo account.

DELETE /v1/qr/{id}

Elimina un QR code.

Crea un QR code

Invia un POST a /v1/qr con il tipo e il target. Imposta dynamic: true per ottenere un codice modificabile e tracciabile che puoi aggiornare in seguito. La risposta include URL di immagini PNG e SVG pronti all'uso.

Richiesta

curl https://api.codesqr.com/v1/qr \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "url",
    "target": "https://example.com/spring-sale",
    "dynamic": true,
    "title": "Spring Sale Poster",
    "color": { "dark": "#059669", "light": "#ffffff" },
    "format": "png"
  }'

Risposta

{
  "id": "qr_8fK2p1Qz",
  "type": "url",
  "target": "https://example.com/spring-sale",
  "dynamic": true,
  "short_url": "https://csqr.io/8fK2p1Qz",
  "image_url": "https://cdn.codesqr.com/qr/8fK2p1Qz.png",
  "svg_url": "https://cdn.codesqr.com/qr/8fK2p1Qz.svg",
  "scans": 0,
  "created_at": "2026-07-18T10:24:00Z"
}

Aggiorna un codice dinamico

Poiché un QR code dinamico mantiene lo stesso pattern stampato, puoi indirizzarlo verso una nuova destinazione in qualsiasi momento con un PATCH. I codici già stampati continuano a funzionare, nessuna ristampa richiesta.

Richiesta

curl -X PATCH https://api.codesqr.com/v1/qr/qr_8fK2p1Qz \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "target": "https://example.com/summer-sale" }'

Leggi le statistiche delle scansioni

Per i codici dinamici, recupera le analisi delle scansioni con un GET a /v1/qr/{id}/stats. Ottieni i totali, una ripartizione giornaliera e una suddivisione per dispositivo che puoi mettere in grafico o esportare.

Richiesta

curl https://api.codesqr.com/v1/qr/qr_8fK2p1Qz/stats \
  -H "Authorization: Bearer sk_live_your_api_key"

Risposta

{
  "id": "qr_8fK2p1Qz",
  "total_scans": 1842,
  "unique_scans": 1310,
  "range": "last_30_days",
  "by_day": [
    { "date": "2026-07-16", "scans": 74 },
    { "date": "2026-07-17", "scans": 91 },
    { "date": "2026-07-18", "scans": 63 }
  ],
  "by_device": { "mobile": 1521, "desktop": 248, "tablet": 73 }
}

Limiti di frequenza ed errori

L'API restituisce codici di stato HTTP standard: 200 in caso di successo, 400 per una richiesta malformata, 401 per una chiave errata, e 429 quando superi il limite di frequenza del tuo piano. Le risposte di errore includono un code leggibile dalla macchina e un message leggibile dall'uomo. Preferisci nessun codice? Puoi creare e gestire tutto a mano nell'app, o esplorare prima tutti i tipi di QR code.

Pronto a costruire?

Crea un account CodesQR gratuito, genera una chiave API in Impostazioni e crea il tuo primo QR code con una singola richiesta.

Crea un account gratuito

Il tuo QR Code tracciabile è a un minuto di distanza

Punta un codice a qualsiasi link o file, traccia ogni scansione e cambia la destinazione ogni volta che ti serve.

Crea il mio QR Code gratis

Gratis per sempre
Nessuna carta di credito
Pronto in pochi minuti