Cómo generar un código QR a partir de texto o una URL

Qué puedes preparar antes de empezar

Este generador convierte contenido proporcionado, como texto o una URL, en una imagen de código QR cuando la generación termina correctamente. El resultado se representa como una cadena base64 que corresponde a un PNG, por lo que el flujo adecuado consiste en preparar el contenido, escoger las opciones necesarias y comprobar la respuesta recibida.

La herramienta puede resultar útil cuando necesitas transformar una dirección web o un mensaje en un código visual. La entrada principal no es obligatoria, aunque una ejecución sin contenido no produce una imagen. También puedes proporcionar el valor mediante la entrada principal o mediante un alias destinado a texto, URL o contenido.

Pasos para generar la imagen

1. Introduce el contenido que quieres codificar. Escribe un texto no vacío o una URL en la entrada principal, o utiliza uno de los alias disponibles para texto, URL o contenido. Si omites esa entrada, su valor queda vacío y no se genera ninguna imagen.

2. Decide el tamaño de la imagen. Si no indicas una medida, se toma 256 como valor inicial. La medida suministrada se convierte a un número entero; si la conversión provoca un error de tipo o de valor, se recupera 256. Después, el valor normalizado se mantiene dentro del intervalo de 64 a 1024.

3. Selecciona la corrección de errores cuando necesites configurarla. Los valores de texto admitidos son L, M, Q y H, y se normalizan a mayúsculas. Si escribes otro valor, se utiliza M como alternativa.

4. Revisa los colores de la imagen. La configuración predeterminada emplea negro en el primer plano y blanco en el fondo, mientras que ambos colores pueden personalizarse según el uso previsto.

5. Ejecuta la generación y examina la respuesta. Cuando el contenido no está vacío y la operación termina correctamente, debe aparecer una imagen de código QR en formato PNG, representada por una cadena base64 no vacía. Elige después el tratamiento que corresponda a ese resultado dentro de tu flujo de trabajo, sin confundir la representación base64 con un archivo PNG independiente.

Qué significa la respuesta

Una respuesta con una cadena base64 no vacía indica que se ha devuelto la representación de una imagen PNG. Para comprobar el formato, esa cadena debe poder decodificarse como PNG válido; aun así, este dato no establece por sí solo otras propiedades de calidad o de lectura del código.

La medida elegida describe el valor normalizado que se utiliza para calcular la escala de los módulos del QR, no una promesa sobre el número final de píxeles. Por ese motivo, las dimensiones del PNG pueden diferir de la medida solicitada, incluso después de aplicar el intervalo permitido.

Si no aparece una imagen, comprueba primero que se haya enviado contenido y que no esté vacío. La ausencia de resultado también puede deberse a un fallo de generación o a una dependencia necesaria que no esté disponible, así que una respuesta sin imagen no identifica por sí misma la causa. Los valores de corrección no reconocidos se sustituyen por M, mientras que un tamaño que no pueda convertirse vuelve a 256 antes de limitarse al intervalo previsto.

Ejemplo práctico

Una asociación de España quiere preparar un código QR que dirija a su página de inscripción.

Introduce la dirección web de la página de inscripción de una asociación, selecciona un tamaño de 512 y una corrección Q, y ejecuta la generación.

Si el contenido no está vacío y la operación termina correctamente, se devuelve una cadena base64 no vacía que se puede decodificar como una imagen PNG válida del código QR. Las dimensiones finales del PNG pueden diferir de 512 píxeles.

Limitaciones

• El contenido vacío, un fallo de generación o una dependencia no disponible pueden dejar la respuesta sin imagen; el resultado satisfactorio está descrito como PNG.

Errores frecuentes

• Dejar sin valor la entrada principal hace que el contenido predeterminado permanezca vacío; escribe un texto o una URL antes de iniciar la generación.

Preguntas frecuentes

¿Qué ocurre si dejo vacío el contenido?

Cuando no se envía contenido, la entrada principal conserva su valor vacío y el proceso termina sin producir una imagen. Añade un texto o una dirección web antes de volver a ejecutarlo.

¿Puedo crear un QR a partir de una URL?

Sí, puedes suministrar una URL mediante la entrada principal o mediante el alias correspondiente a texto, URL o contenido. La generación requiere que el valor enviado no esté vacío.

¿En qué formato se devuelve la imagen?

Una operación satisfactoria devuelve una cadena base64 no vacía que representa un PNG. La anchura y la altura resultantes pueden no coincidir con el tamaño solicitado, porque se calculan a partir de una escala entera para los módulos.