API Generatore QR Code

Genera immagini di codici QR aggiungendo .qr.png a qualsiasi collegamento 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 degli occhi e loghi.

Utilizzo di base

Aggiungi .qr.png a qualsiasi collegamento breve Linkly:

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

Questo restituisce un'immagine PNG di 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, un PDF o qualsiasi sistema che supporti URL di immagini.

Parametri di stile

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

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

Nota: i colori esadecimali devono essere codificati per 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.

quietZone aggiunge spaziatura bianca intorno all'intero codice QR, riempita con bgColor. Questo è utile quando stampi codici QR su sfondi scuri — senza di esso, gli occhi di posizionamento si trovano a contatto 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 dei collegamenti

Puoi salvare gli stili del codice QR a un collegamento quando lo crei o lo aggiorni tramite l'API per l'accorciamento dei collegamenti. 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 apportato nell'editor del codice QR o impostato tramite l'API dei collegamenti viene archiviata con il collegamento
3. 3
   Override dei parametri di query — Ignora gli stili individuali per richiesta tramite parametri URL

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

Limiti di velocità

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 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 brandizzati con il logo della tua azienda
• Codici QR SVG - Scarica codici QR in formato vettoriale scalabile
• API per l'accorciamento dei collegamenti - Crea e gestisci i collegamenti a livello di programmazione
• API Analytics - Esporta dati di clic e rapporti sul traffico