API Generatore di Codici QR

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

Aggiungi .qr.png a qualsiasi collegamento 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.

Incorpora un codice QR in una pagina HTML:

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

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

Passa parametri di query per sovrascrivere gli stili QR salvati del collegamento 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 URL — usa %23 al posto di # (ad es. %23ff0000 per #ff0000).

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

Il quietZone aggiunge spaziatura interna intorno all'intero codice QR, riempita con bgColor. Questo è utile quando si stampano codici QR su sfondi scuri — senza di esso, gli occhi di posizionamento rimangono a filo del bordo e potrebbero non eseguire la scansione in modo affidabile. Ad esempio, quietZone=50&bgColor=%23ffffff aggiunge un bordo bianco di 50 pixel.

Puoi salvare gli stili del codice QR su un collegamento quando lo crei o lo aggiorni tramite l'API di Abbreviazione 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 quando richiedi l'immagine .qr.png — non sono necessari parametri di query.

Gli stili del codice QR vengono risolti nel seguente ordine:

1. 1Stili predefiniti — Primo piano nero su sfondo trasparente, moduli quadrati, 1024px
2. 2Stili salvati — Qualsiasi personalizzazione che hai fatto nell'editor del codice QR o impostato tramite l'API di Collegamento viene memorizzata con il collegamento
3. 3Override dei parametri di query — Sovrascrivi gli stili individuali per richiesta tramite parametri URL

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

L'endpoint è limitato a 5 richieste al secondo per indirizzo IP. Le immagini sono memorizzate nella cache per 5 minuti, quindi le richieste ripetute per lo stesso codice QR vengono servite rapidamente.

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": "Limite di frequenza superato"}

• Crea Codici QR - Come creare e personalizzare codici QR in Linkly
• Aggiungi un Logo a un Codice QR - Crea codici QR con marchio con il logo della tua azienda
• Codici QR SVG - Scarica codici QR in formato vettoriale scalabile
• API di Abbreviazione dei Collegamenti - Crea e gestisci i collegamenti a livello di programmazione
• API di Analitiche - Esporta dati dei clic e rapporti sul traffico