Leer un Código QR desde una imagen
- Panel
- Documentación
- API
¿Por qué utilizar una herramienta de lectura de códigos QR?
Los códigos QR están por todas partes: carteles, etiquetas, facturas, tarjetas de visita, cartas de restaurante. Codifican URL, contactos, credenciales wifi o simples cadenas de texto. Esta herramienta le permite decodificar el contenido de un código QR a partir de una imagen, sin tener que utilizar su smartphone.
Características de la herramienta de lectura de códigos QR
La herramienta acepta una imagen en formato JPEG, PNG, GIF, WebP o BMP, con un tamaño máximo de 10 MB. Analiza el código QR detectado en la imagen y devuelve su contenido textual. No se conserva ninguna imagen en el servidor tras el tratamiento.
Cómo utilizar la herramienta de lectura de códigos QR
Seleccione una imagen que contenga un código QR legible y, a continuación, haga clic en el botón "Decodificar". El contenido decodificado se muestra en la zona de resultado, listo para copiarse.
Consejos para una buena decodificación
Para maximizar las posibilidades de detección, utilice una imagen nítida y bien contrastada, recortada alrededor del código QR. Evite las imágenes demasiado oscuras, borrosas o deformadas. Si la imagen proviene de una foto, enderécela antes de enviarla.
Preguntas frecuentes
¿Qué formatos de imagen puedo subir?
La herramienta acepta JPEG, PNG, GIF, WebP y BMP, hasta un límite de 10 MB por fichero. Si su código QR está en un PDF, expórtelo primero a imagen (captura de pantalla, exportación de imagen en Vista Previa en macOS o clic derecho sobre una página en Acrobat). El decodificador no lee directamente los ficheros PDF.
¿Funciona la decodificación con una foto tomada con smartphone?
Sí, siempre que la foto esté nítida y bien iluminada. Si el QR está ligeramente inclinado, la decodificación sigue siendo posible: la especificación permite cierta tolerancia gracias a los marcadores de posición en las esquinas. Para los casos difíciles, recorte la imagen alrededor del QR antes de enviarla para eliminar las distracciones visuales.
¿Se conserva la imagen subida?
No. La imagen se procesa durante el tiempo de la petición y después se elimina. El contenido textual decodificado se devuelve en la respuesta, pero no se almacena en el lado del servidor. No se llama a ningún servicio de terceros para el análisis, todo ocurre en nuestra infraestructura.
¿Por qué la herramienta no detecta ningún QR en mi imagen?
Varias causas posibles: imagen demasiado pequeña o demasiado oscura, QR parcialmente oculto, perspectiva demasiado acentuada o contraste insuficiente. Vuelva a intentarlo con una imagen recortada y enderezada. Si el QR lleva un logotipo central demasiado grande, su corrección de errores quizá se saturó al generarlo, lo que impide cualquier relectura.
¿Funciona con Datamatrix o códigos de barras clásicos?
No, esta herramienta se limita a los códigos QR en sentido estricto (norma ISO/IEC 18004). Los Datamatrix, EAN, Code 128 o Aztec utilizan otros formatos de lectura. Para esos estándares, hace falta un lector dedicado; todavía no ofrecemos una herramienta correspondiente.
¿Cómo se genera un código QR a partir de un texto o de una URL?
Utilice nuestro generador de código QR: introduzca su texto o su URL, elija la salida PNG o SVG y recupere la imagen lista para imprimir o integrar en una página web. Se recomienda el SVG para la impresión en gran formato.
Ejemplo de solicitud
curl -X POST https://cdrn.fr/api/v1/tools/qr-code-reader/execute \
-F "image=@/path/to/file"Esquema de entrada
| Campo | Tipo | Obligatorio | Por defecto |
|---|---|---|---|
image |
file | – |
esta herramienta espera un archivo - utiliza Content-Type multipart/form-data en lugar de application/json
Puntos de acceso
GET https://cdrn.fr/api/v1/tools- lista todas las herramientas disponiblesGET https://cdrn.fr/api/v1/tools/qr-code-reader- recupera el esquema de esta herramientaPOST https://cdrn.fr/api/v1/tools/qr-code-reader/execute- ejecuta esta herramienta con un payload JSON