API Generatore Codici QR

Genera immagini di codici QR aggiungendo .qr.png a qualsiasi link breve 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 occhio e loghi.

Utilizzo di Base

Aggiungi .qr.png a qualsiasi link breve 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" />

O utilizzalo in un template email, un PDF, o qualsiasi sistema che supporti URL di immagini.

Parametri di Stile

Passa parametri di query per sovrascrivere gli stili QR salvati del link o per modificare la dimensione dell'immagine:

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

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

Le dimensioni del logo vengono automaticamente ridimensionate in base alla dimensione dell'immagine richiesta.

La quietZone aggiunge spaziatura bianca attorno all'intero codice QR, riempita con bgColor. Questo è utile quando si stampano codici QR su sfondi scuri — senza di essa, gli occhi di posizionamento sono a filo con il bordo e potrebbero non scansionarsi affidabilmente. 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 in un link quando lo crei o lo aggiorna tramite l'API di 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 — non servono parametri di query.

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 apportato nell'editor del codice QR o impostato tramite l'API Link viene archiviata con il link
3. 3
   Override dei parametri di query — Sovrascrivi singoli stili per richiesta tramite parametri URL

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

Limiti di Frequenza

L'endpoint è limitato a 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 lo 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 marchio della tua azienda
• Codici QR SVG - Scarica codici QR in formato vettoriale scalabile
• API di Accorciamento Link - Crea e gestisci link a livello di programmazione
• API Analytics - Esporta dati di clic e report sul traffico