Generare un QR Code (PNG, SVG, WebP o GIF)

Dashboard
Documentazione
API

genera istantaneamente un QR Code (PNG, SVG, WebP o GIF) da un URL, un testo, un wifi o un contatto. Personalizza i colori, integra il tuo logo al centro e scegli tra moduli quadrati o tondi

Perché usare uno strumento di generazione di codici QR?

I codici QR sono codici a barre bidimensionali che possono memorizzare informazioni leggibili dalle macchine. Sono comunemente usati per codificare URL, testi, coordinate geografiche e molto altro. Uno strumento di generazione di codici QR vi permette di creare facilmente codici QR a partire da diverse sorgenti di dati, facilitando così la condivisione di informazioni e l'accesso rapido a risorse.

Caratteristiche dello strumento di generazione di codici QR

Questo strumento prende in input una stringa di testo (URL, contenuto libero, dati strutturati) e produce il codice QR corrispondente. Scegli il formato di output tra PNG, SVG, WebP o GIF, personalizza i colori in primo piano e di sfondo, e integra opzionalmente un logo al centro del codice per i tuoi materiali di brand.

Come usare lo strumento di generazione di codici QR

Inserisci la stringa di testo da codificare e seleziona il formato di output desiderato (PNG, SVG, WebP o GIF). Regola i colori in primo piano e di sfondo tramite gli appositi selettori e carica opzionalmente un logo PNG, JPG o WebP di meno di 2 MB da integrare al centro del codice. Fai clic su «Genera»: lo strumento mostra le due varianti visive affiancate, moduli quadrati (QR classico) e moduli tondi (look moderno), per lasciarti scegliere quella che preferisci.

Se il contrasto tra i due colori scelti è troppo basso o invertito (chiaro su scuro), viene mostrato un avviso: la leggibilità da parte degli scanner non è più garantita.

Domande frequenti

Qual è la quantità massima di testo che posso codificare?

Lo standard QR consente fino a circa 4 296 caratteri alfanumerici o 2 953 byte grezzi. In pratica, più grande è il payload, più denso e difficile da scansionare diventa il QR per uno smartphone. Restate preferibilmente sotto qualche centinaia di caratteri per mantenere una lettura fluida anche su uno schermo di dimensioni modeste.

Quale formato di output scegliere: PNG, SVG, WebP o GIF?

PNG è il formato versatile per default, perfetto per l'invio via email e l'integrazione web classica. SVG è vettoriale: rimane nitido a qualsiasi dimensione, ideale per la stampa in grande formato (poster, roll-up) o per la stilizzazione tramite CSS. WebP produce file ~25 % più leggeri di PNG a parità di resa, interessante per ridurre il peso delle pagine. GIF resta utile soprattutto per la retrocompatibilità con sistemi più datati.

Posso personalizzare i colori e aggiungere un logo?

Sì. I selettori di colore permettono di definire liberamente il primo piano (i moduli scuri) e lo sfondo. Un logo PNG, JPG o WebP (fino a 2 MB) può essere integrato al centro del QR: viene automaticamente circondato da un disco bianco per un'integrazione pulita indipendentemente dal suo sfondo, e il livello di correzione d'errore viene aumentato per compensare la superficie occupata. Affinché il QR resti leggibile, mantieni un contrasto forte, conserva il primo piano più scuro dello sfondo (la maggior parte dei lettori non legge i QR invertiti), e stampa o visualizza il codice a una dimensione minima di circa 2 cm di lato.

I miei dati vengono inviati a un servizio terzo?

No. La generazione viene effettuata dal nostro server, senza chiamate a servizi esterni e senza conservazione dopo l'invio del risultato. Il testo o l'URL che codificate non lascia la nostra infrastruttura e non viene registrato in chiaro nei log applicativi.

Si può codificare un URL con parametri UTM?

Assolutamente. Un URL con parametri come ?utm_source=poster&utm_medium=qr viene codificato così com'è. Potrete poi monitorare le visite provenienti dal QR nel vostro strumento di analytics. Tenete solo presente che più lungo è l'URL, più denso sarà il QR.

Un codice QR può scadere o essere revocato?

No di per sé. Una volta stampato, un codice QR codifica un testo fisso e questo testo non cambierà più. Se prevedete di modificare la destinazione in seguito, codificate un URL corto che controllate (il vostro redirettore) piuttosto che l'URL finale. Potrete così cambiare il target senza ristampare il QR.

Come decodificare un codice QR esistente?

Usate il nostro lettore di codici QR: caricate l'immagine del QR (JPEG, PNG, GIF, WebP o BMP) e recuperate il suo contenuto testuale. È pratico per verificare ciò che è stato codificato prima della stampa, o per decodificare un QR ricevuto come allegato senza usare il vostro smartphone.

Esempio di richiesta

curl -X POST https://cdrn.fr/api/v1/tools/qr-code-encoder/execute \
  -H "Content-Type: application/json" \
  -d '{"data":"...","output_format":"png","module_style":"squares","foreground_color":"#000000","background_color":"#ffffff"}'

curl -X POST https://cdrn.fr/api/v1/tools/qr-code-encoder/execute \
  -F "data=..." \
  -F "output_format=png" \
  -F "module_style=squares" \
  -F "logo=@/path/to/file" \
  -F "foreground_color=#000000" \
  -F "background_color=#ffffff"

Schema di input

Campo	Tipo	Richiesto	Predefinito
`data`	string	✓	–
`output_format`	choice (png, svg, webp, gif)	✓	–
`module_style`	string (squares, dots, both)	–	`squares`
`logo`	file	–	–
`foreground_color`	string	–	`#000000`
`background_color`	string	–	`#ffffff`

questo strumento accetta anche un file opzionale - usa Content-Type multipart/form-data per caricarlo, altrimenti application/json è sufficiente

Endpoint

GET https://cdrn.fr/api/v1/tools - elenca tutti gli strumenti disponibili
GET https://cdrn.fr/api/v1/tools/qr-code-encoder - recupera lo schema di questo strumento
POST https://cdrn.fr/api/v1/tools/qr-code-encoder/execute - esegue questo strumento con un payload JSON