API del Generatore di 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 del codice QR salvati applicati, inclusi colori personalizzati, motivi a punti, stili degli occhi e logo.

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

https://your-domain.com/ABC123.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, quegli stili vengono applicati automaticamente.

Incorpora un codice QR in una pagina HTML:

<img src="https://your-domain.com/ABC123.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 link o modificare la dimensione dell'immagine:

https://your-domain.com/ABC123.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

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

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

Puoi salvare gli stili del codice QR su un link quando lo crei o lo aggiorni tramite l'API di Accorciamento Link. Passa un oggetto JSON qr_styles con 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"
  }
}

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

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 effettuata nell'editor di codici QR o impostata tramite l'API dei Link viene memorizzata con il link
3. 3Sovrascritture dei parametri di query — Sovrascrivi stili individuali per richiesta tramite parametri URL

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

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.

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"}

• 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 di Accorciamento Link - Crea e gestisci link programmaticamente
• API di Analisi - Esporta dati sui clic e report sul traffico