# Lector de Códigos QR

Lee un código QR desde una imagen, el portapapeles o la cámara, sin subir nada

- Página: https://herramient.as/leer-codigo-qr
- Categoría: Generadores
- Dónde se ejecuta: en el navegador, los datos no salen del dispositivo

Es una herramienta interactiva: se usa desde el navegador en https://herramient.as/leer-codigo-qr.

## Uso por API

También se puede usar por API REST, con una clave en la cabecera `Authorization: Bearer htas_...`. Referencia completa: https://herramient.as/api-docs.md

### `POST /api/v1/tools/images/decode_qr`

Lee los códigos QR o de barras de una imagen

Devuelve una lista porque una imagen puede traer varios códigos; una hoja con cuatro QR impresos es un caso corriente. Lee además códigos de barras de una dimensión (EAN-13, CODE-128 y los demás que reconoce ZBar), y el campo type dice de cuál se trata. La imagen se descodifica con libvips, así que admite JPEG, PNG, WebP, AVIF y TIFF. No se almacena. El contenido se devuelve como texto y nada más: no se interpreta, no se sigue y no se valida como URL. Un código lo escribió quien lo generó, de modo que convertirlo en algo navegable es decisión de quien llama.

Consume 2 unidades de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `file` | file | sí | La imagen con el código, como multipart/form-data. Máximo 25 MB |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `found` | boolean | Si se encontró al menos un código |
| `symbols` | array | Cada uno con data (el contenido como texto), type (QR-Code, EAN-13, CODE-128...) y quality (la confianza que da ZBar; baja en fotos borrosas) |

**Errores**

- `400`: Falta el fichero, no es un fichero o supera 25 MB
- `422`: El fichero está dañado o no es una imagen que sepamos decodificar
- `503`: El servicio de procesamiento no está disponible. Reintenta según Retry-After

```bash
curl -X POST https://herramient.as/api/v1/tools/images/decode_qr \
  -H "Authorization: Bearer htas_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Preguntas frecuentes

### ¿Se sube mi imagen a algún servidor?

No. El código se descifra en tu propio navegador, con un programa que se descarga una vez y se ejecuta en tu equipo. La imagen no se envía a ninguna parte, y si usas la cámara, el vídeo tampoco: se analiza fotograma a fotograma en tu dispositivo y no se graba nada.

### ¿Puedo leer un QR que tengo en la pantalla del ordenador?

Sí, y es el caso más habitual: un QR que llega por correo no puedes leerlo apuntando el móvil a tu propia pantalla. Haz una captura y pégala aquí con Ctrl+V, o guarda la imagen y suéltala en la caja. También puedes arrastrar la imagen directamente desde el correo.

### No detecta el código, ¿qué hago?

Lo más frecuente es que el código salga demasiado pequeño dentro de la imagen. Recorta la foto para que el QR ocupe buena parte de ella y vuelve a probar. Si es una foto de un cartel, procura que esté enfocado, de frente y sin brillos: un QR fotografiado muy de lado deja de ser legible. Nosotros ya reintentamos en blanco y negro con el contraste forzado, que rescata la mayoría de las capturas con fondo de color.

### ¿Qué tipos de código reconoce?

Códigos QR, en cualquiera de sus versiones y también en negativo (claro sobre oscuro), que es como los pintan algunas apps de banca. Te decimos además qué clase de contenido lleva: un enlace, una red wifi, un contacto, un teléfono, unas coordenadas o texto suelto. No lee códigos de barras de una dimensión, los de los productos del supermercado.

### ¿Es seguro abrir el enlace que lleva dentro?

Un QR es texto escrito por quien lo generó, así que vale lo mismo que un enlace que te llega por mensaje: si no sabes de quién viene, no lo abras. Por eso te mostramos primero la dirección completa en texto y solo ofrecemos el botón de abrir cuando es http o https. Pegar un QR falso encima del de verdad es una estafa corriente en parquímetros, cartas de restaurante y recibos.

### ¿Y si lo que quiero es crear un código QR?

Tenemos la herramienta de al lado: el generador de QR, que crea el código en PNG o SVG, con tus colores y tu logo. Las dos son la misma pareja, una para cada dirección.

## Herramientas relacionadas

- [Generador de códigos QR](https://herramient.as/qr): Crea códigos QR en PNG o SVG para compartir enlaces y texto. Máximo 2.000 caracteres. Los archivos se eliminan automáticamente en 24 horas.
- [Ver Metadatos de Foto](https://herramient.as/ver-metadatos-foto): Mira qué lleva dentro una foto: cámara, fecha, ubicación GPS y datos ocultos
- [Generador DNI/NIE](https://herramient.as/dni-nif-generator): Genera números de identificación españoles (DNI, NIE) válidos con letra de control correcta para pruebas.
- [Generador de UUID](https://herramient.as/uuid): Genera identificadores únicos universales (UUIDv4) para tus aplicaciones. Puedes generar hasta 10 a la vez.