Generar un código QR (PNG, SVG, WebP o GIF)
- Panel
- Documentación
- API
¿Por qué utilizar una herramienta de generación de códigos QR?
Los códigos QR son códigos de barras en dos dimensiones que pueden almacenar información legible por máquina. Se utilizan habitualmente para codificar URL, textos, coordenadas geográficas y mucho más. Una herramienta de generación de códigos QR le permite crear fácilmente códigos QR a partir de distintas fuentes de datos, facilitando así el intercambio de información y el acceso rápido a recursos.
Características de la herramienta de generación de códigos QR
Esta herramienta toma como entrada una cadena de texto (URL, contenido libre, datos estructurados) y genera el código QR correspondiente. Elige el formato de salida entre PNG, SVG, WebP o GIF, personaliza los colores de primer plano y de fondo, e integra opcionalmente un logo en el centro del código para tus soportes de marca.
Cómo utilizar la herramienta de generación de códigos QR
Introduce la cadena de texto a codificar y selecciona el formato de salida deseado (PNG, SVG, WebP o GIF). Ajusta los colores de primer plano y de fondo mediante los selectores correspondientes y sube opcionalmente un logo PNG, JPG o WebP de menos de 2 MB para integrarlo en el centro del código. Haz clic en «Generar»: la herramienta muestra las dos variantes visuales una al lado de la otra, módulos cuadrados (QR clásico) y módulos redondos (estilo moderno), para que elijas la que prefieras.
Si el contraste entre los dos colores elegidos es demasiado bajo o está invertido (claro sobre oscuro), aparece un aviso: la legibilidad por parte de los lectores ya no está garantizada.
Preguntas frecuentes
¿Cuál es la cantidad máxima de texto que puedo codificar?
El estándar QR permite hasta unos 4 296 caracteres alfanuméricos o 2 953 octetos en bruto. En la práctica, cuanto mayor sea la carga útil, más denso será el QR y más difícil de escanear con un smartphone. Manténgase preferiblemente por debajo de unos cientos de caracteres para conservar una lectura fluida incluso en una pantalla de tamaño modesto.
¿Qué formato de salida elegir: PNG, SVG, WebP o GIF?
PNG es el formato versátil por defecto, perfecto para el envío por correo electrónico y la integración web clásica. SVG es vectorial: se mantiene nítido a cualquier tamaño, ideal para impresión en gran formato (cartel, roll-up) o estilización con CSS. WebP produce archivos ~25 % más ligeros que PNG con un renderizado equivalente, interesante para reducir el peso de las páginas. GIF resulta principalmente útil para la retrocompatibilidad con sistemas antiguos.
¿Puedo personalizar los colores y añadir un logo?
Sí. Los selectores de color permiten definir libremente el primer plano (los módulos oscuros) y el fondo. Se puede integrar un logo PNG, JPG o WebP (hasta 2 MB) en el centro del QR: queda automáticamente rodeado por un disco blanco para una integración limpia sea cual sea su fondo, y el nivel de corrección de errores se eleva para compensar la superficie ocupada. Para que el QR siga siendo legible, mantén un contraste fuerte, conserva el primer plano más oscuro que el fondo (la mayoría de los lectores no lee los QR invertidos), e imprime o muestra el código a un tamaño mínimo de unos 2 cm por lado.
¿Se envían mis datos a un servicio de terceros?
No. La generación se realiza en nuestro servidor, sin llamada a un servicio externo y sin conservación tras el envío del resultado. El texto o la URL que codifique no sale de nuestra infraestructura y no se registra en claro en los logs de la aplicación.
¿Se puede codificar una URL con parámetros UTM?
Por supuesto. Una URL con parámetros como ?utm_source=affiche&utm_medium=qr
se codifica tal cual. Después podrá seguir las visitas procedentes del QR en su herramienta
de analítica. Tenga en cuenta que cuanto más larga sea la URL, más denso será el QR.
¿Puede caducar o revocarse un código QR?
No en sí mismo. Una vez impreso, un código QR codifica un texto fijo y ese texto no cambiará nunca. Si prevé modificar el destino posteriormente, codifique una URL corta que usted controle (su propio redirector) en lugar de la URL final. Así podrá cambiar el destino sin volver a imprimir el QR.
¿Cómo se decodifica un código QR existente?
Utilice nuestro lector de códigos QR: suba la imagen del QR (JPEG, PNG, GIF, WebP o BMP) y recupere su contenido textual. Es práctico para comprobar lo que se ha codificado antes de imprimir, o para decodificar un QR recibido en un adjunto sin utilizar su smartphone.
Ejemplo de solicitud
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"
Esquema de entrada
| Campo | Tipo | Obligatorio | Por defecto |
|---|---|---|---|
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 |
esta herramienta también acepta un archivo opcional - usa Content-Type multipart/form-data para subirlo, si no application/json es suficiente
Puntos de acceso
GET https://cdrn.fr/api/v1/tools- lista todas las herramientas disponiblesGET https://cdrn.fr/api/v1/tools/qr-code-encoder- recupera el esquema de esta herramientaPOST https://cdrn.fr/api/v1/tools/qr-code-encoder/execute- ejecuta esta herramienta con un payload JSON