Generarea unui QR Code (PNG, SVG, WebP sau GIF)
- Panou de control
- Documentație
- API
De ce să utilizezi un instrument de generare de QR coduri?
QR codurile sunt coduri de bare în două dimensiuni care pot stoca informații lizibile de mașini. Sunt frecvent utilizate pentru a coda URL-uri, texte, coordonate geografice, și multe altele. Un instrument de generare de QR coduri îți permite să creezi ușor QR coduri din diferite surse de date, facilitând astfel partajarea informațiilor și accesul rapid la resurse.
Caracteristicile instrumentului de generare de QR coduri
Acest instrument ia ca intrare un șir de text (URL, conținut liber, date structurate) și produce QR codul corespunzător. Alege formatul de ieșire între PNG, SVG, WebP sau GIF, personalizează culorile prim-plan și fundal, și integrează opțional un logo în centrul codului pentru suporturile tale de brand.
Cum să utilizezi instrumentul de generare de QR coduri
Introdu șirul de text de codat și selectează formatul de ieșire dorit (PNG, SVG, WebP sau GIF). Ajustează culorile prim-plan și fundal prin selectoarele dedicate, și încarcă opțional un logo PNG, JPG sau WebP de sub 2 Mo de integrat în centrul codului. Apasă pe "Generează": instrumentul afișează cele două variante vizuale una lângă alta, module pătrate (QR clasic) și module rotunde (look modern), pentru a te lăsa să alegi pe cea pe care o preferi.
Odată generat, QR codul se afișează pe ecran și poți să-l copiezi prin butonul dedicat. Dacă contrastul între cele două culori este prea slab sau inversat (deschis pe închis), un avertisment se afișează: lizibilitatea de către scanere nu mai este garantată.
Întrebări frecvente
Care este cantitatea maximă de text pe care o pot coda?
Standardul QR autorizează până la aproximativ 4 296 de caractere alfanumerice sau 2 953 de octeți bruți. În practică, cu cât încărcătura utilă este mai mare, cu atât QR-ul este mai dens și mai dificil de scanat de un smartphone. Rămâi de preferință sub câteva sute de caractere pentru a păstra o citire fluidă chiar și pe un ecran de dimensiuni modeste.
Ce format de ieșire să aleg: PNG, SVG, WebP sau GIF?
PNG este formatul polivalent implicit, perfect pentru trimiterea prin e-mail și integrarea web clasică. SVG este vectorial: rămâne clar la orice dimensiune, ideal pentru imprimarea în format mare (afiș, kakemono) sau stilizarea CSS. WebP produce fișiere cu ~25% mai ușoare decât PNG pentru o randare echivalentă, interesant pentru a reduce greutatea paginilor. GIF rămâne în principal util pentru retrocompatibilitatea cu sisteme vechi.
Pot personaliza culorile și adăuga un logo?
Da. Selectoarele de culori permit definirea liberă a prim-planului (modulele întunecate) și a fundalului. Un logo PNG, JPG sau WebP (până la 2 Mo) poate fi integrat în centrul QR-ului: este automat înconjurat de un disc alb pentru o integrare curată indiferent de fundalul său, iar nivelul de corecție a erorii este ridicat pentru a compensa suprafața ocupată. Pentru ca un QR să rămână lizibil, păstrează un contrast puternic, păstrează prim-planul mai întunecat decât fundalul (majoritatea scanerelor nu citesc QR-uri inversate), și imprimă sau afișează la o dimensiune minimă de aproximativ 2 cm pe latură.
Datele mele sunt trimise la un serviciu terț?
Nu. Generarea este realizată de serverul nostru, fără apel la un serviciu extern și fără păstrare după trimiterea rezultatului. Textul sau URL-ul pe care îl codezi nu părăsește infrastructura noastră și nu este jurnalizat în clar în log-urile aplicației.
Pot coda un URL cu parametri UTM?
Absolut. Un URL cu parametri precum ?utm_source=afis&utm_medium=qr
este codat ca atare. Vei putea apoi urmări vizitele provenite din QR în instrumentul tău
de analytics. Gândește-te doar că, cu cât URL-ul este mai lung, cu atât QR-ul va fi mai dens.
Poate un QR cod să expire sau să fie revocat?
Nu în sine. Odată imprimat, un QR cod codează un text fix și acest text nu se va mai schimba. Dacă prevezi modificarea destinației ulterior, codează un URL scurt pe care îl controlezi (propriul tău redirector) în loc de URL-ul final. Vei putea atunci să schimbi ținta fără să reimprimi QR-ul.
Cum să decodez un QR cod existent?
Utilizează cititorul nostru de QR cod: încarcă imaginea QR-ului (JPEG, PNG, GIF, WebP sau BMP) și recuperează conținutul său textual. Este practic pentru a verifica ce a fost codat înainte de imprimare, sau pentru a decoda un QR primit ca atașament fără a utiliza smartphone-ul tău.
Exemplu de cerere
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 de intrare
| Câmp | Tip | Obligatoriu | Implicit |
|---|---|---|---|
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 |
acest instrument acceptă și un fișier opțional - utilizați Content-Type multipart/form-data pentru a-l încărca, altfel application/json este suficient
Puncte de acces
GET https://cdrn.fr/api/v1/tools- listează toate instrumentele disponibileGET https://cdrn.fr/api/v1/tools/qr-code-encoder- obține schema acestui instrumentPOST https://cdrn.fr/api/v1/tools/qr-code-encoder/execute- execută acest instrument cu un payload JSON