API Generatore Codici QR

Genera immagini di codici QR aggiungendo .qr.png a qualsiasi link breve di Linkly. Nessuna autenticazione o chiave API richiesta.

L'immagine viene restituita come PNG con tutti gli stili di codice QR salvati applicati, inclusi colori personalizzati, pattern di punti, stili degli occhi e loghi.

Utilizzo di base

Aggiungi .qr.png a qualsiasi link breve di Linkly:

https://linkly.link/2W6Z9.qr.png

Questo restituisce un'immagine PNG 1024x1024 del codice QR. Se hai personalizzato i colori, lo stile o il logo del codice QR in Linkly, questi stili vengono applicati automaticamente.

Esempio

Incorpora un codice QR in una pagina HTML:

<img src="https://linkly.link/2W6Z9.qr.png" alt="QR Code" />

Oppure utilizzalo in un modello di email, in un PDF o in qualsiasi sistema che supporti gli URL delle immagini.

Parametri di stile

Passa parametri di query per sostituire gli stili QR salvati del link o per modificare le dimensioni dell'immagine:

https://linkly.link/2W6Z9.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

Nota: i colori esadecimali devono essere codificati in URL — usa %23 al posto di # (ad es. %23ff0000 per #ff0000).

Le dimensioni del logo vengono automaticamente ridimensionate per corrispondere alle dimensioni dell'immagine richiesta.

quietZone aggiunge padding di spazio bianco intorno all'intero codice QR, riempito con bgColor. Questo è utile quando stampi codici QR su sfondi scuri — senza di esso, gli occhi di posizionamento si trovano a filo con il bordo e potrebbero non scansionarsi in modo affidabile. Ad esempio, quietZone=50&bgColor=%23ffffff aggiunge un bordo bianco di 50 pixel.

Impostazione degli stili tramite l'API link

Puoi salvare gli stili del codice QR a un link quando lo crei o lo aggiorna tramite l'API Accorciamento Link. Passa un oggetto JSON qr_styles con una qualsiasi delle chiavi di stile elencate sopra:

{
  "api_key": "your_api_key",
  "workspace_id": 1234,
  "url": "https://example.com",
  "qr_styles": {
    "fgColor": "#009eff",
    "bgColor": "#ffffff",
    "qrStyle": "dots",
    "eyeStyle": "rounded",
    "logoImage": "https://example.com/logo.png",
    "logoWidth": 60,
    "logoHeight": 60,
    "logoPadding": 10,
    "logoStyle": "circle",
    "quietZone": 50
  }
}

Una volta salvati, questi stili vengono applicati automaticamente ogni volta che richiedi l'immagine .qr.png — nessun parametro di query necessario.

Come vengono applicati gli stili

Gli stili del codice QR vengono risolti nel seguente ordine:

1. 1
   Stili predefiniti — Primo piano nero su sfondo trasparente, moduli quadrati, 1024px
2. 2
   Stili salvati — Qualsiasi personalizzazione che hai effettuato nell'editor del codice QR o impostato tramite l'API Link vengono archiviati con il link
3. 3
   Override dei parametri di query — Sostituisci singoli stili per richiesta tramite parametri URL

Quando è presente un logo, Linkly utilizza automaticamente la correzione degli errori di alto livello (Livello H) per garantire che il codice QR rimanga scansionabile.

Limiti di frequenza

L'endpoint ha un limite di frequenza di 5 richieste al secondo per indirizzo IP. Le immagini vengono memorizzate nella cache per 5 minuti, quindi le richieste ripetute per lo stesso codice QR vengono servite rapidamente.

Risposta

Una richiesta riuscita restituisce uno stato 200 con Content-Type: image/png e i dati dell'immagine PNG come corpo della risposta.

Le risposte di errore restituiscono JSON:

{"error": "Rate limit exceeded"}

Risorse correlate

• Crea Codici QR - Come creare e personalizzare codici QR in Linkly
• Aggiungi un Logo a un Codice QR - Crea codici QR con il logo della tua azienda
• Codici QR SVG - Scarica codici QR in formato vettoriale scalabile
• API Accorciamento Link - Crea e gestisci i link in modo programmatico
• API Analytics - Esporta dati di clic e report di traffico