# QR de wifi

Crea un código QR con los datos de tu wifi para que tus clientes o invitados se conecten al escanearlo, sin teclear la contraseña.

- Página: https://herramient.as/qr-wifi
- Categoría: Generadores
- Dónde se ejecuta: en nuestro servidor

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

## 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/qr/wifi`

Genera un código QR para conectarse a una red wifi

Compone el texto WIFI:T:...;S:...;P:...;; que leen las cámaras de iPhone y Android, con los caracteres especiales del nombre y la contraseña ya escapados, y lo dibuja con las mismas opciones de diseño que /qr/generate.

Consume 3 unidades de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `ssid` | string | sí | Nombre de la red, tal cual. Máximo 32 bytes (Ejemplo: `MiCasa_5G`) |
| `password` | string | no | Contraseña. Obligatoria salvo con security=nopass; con WPA, de 8 a 63 caracteres (Ejemplo: `una-clave-larga`) |
| `security` | string | no | WPA cubre WPA, WPA2 y WPA3. Por defecto WPA (Ejemplo: `WPA`) |
| `hidden` | boolean | no | Si la red no emite su nombre. Por defecto false (Ejemplo: `false`) |
| `format` | string | no | Formato de salida. Por defecto png (Ejemplo: `png`) |
| `size` | integer | no | Ancho en píxeles. Por defecto 512. Con firma, el alto es un 8 % mayor (Ejemplo: `1024`) |
| `style` | string | no | Forma de los módulos. Por defecto rounded (Ejemplo: `rounded`) |
| `eyes` | string | no | Forma de las tres esquinas. Por defecto rounded (Ejemplo: `rounded`) |
| `color` | string | no | Color del código en hexadecimal. Por defecto #111827 (Ejemplo: `#1e3a8a`) |
| `eye_color` | string | no | Color de las esquinas. Por defecto el de color (Ejemplo: `#1e3a8a`) |
| `background` | string | no | Color del fondo. Por defecto #ffffff (Ejemplo: `#ffffff`) |
| `caption` | boolean | no | Firma «creado con herramient.as» debajo del código. Por defecto true (Ejemplo: `true`) |
| `icon` | string | no | Icono para el centro del código, dibujado en vectorial. Se ignora si se manda logo (Ejemplo: `wifi`) |
| `logo` | file | no | Imagen PNG, JPG o WebP de hasta 5 MB para el centro del código, como multipart/form-data |
| `logo_size` | string | no | Tamaño del logo. Por defecto medium (Ejemplo: `medium`) |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `url` | string | URL de descarga del fichero generado |
| `expires_at` | string | Cuándo se eliminará el fichero |
| `content` | string | El texto codificado en el QR |
| `format` | string | Formato generado |
| `size` | integer | Ancho pedido |
| `width` | integer | Ancho de la imagen en píxeles |
| `height` | integer | Alto de la imagen en píxeles |
| `warnings` | array | Avisos que pueden impedir escanearlo, como poco contraste. No bloquean la generación |

**Errores**

- `400`: Faltan datos, el contenido no cabe en un QR, o una opción o un color no son válidos
- `422`: El logo no se ha podido leer como imagen
- `503`: El servicio que procesa el logo no está disponible; reintenta en unos segundos

```bash
curl -X POST https://herramient.as/api/v1/tools/qr/wifi \
  -H "Authorization: Bearer htas_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{"ssid":"MiCasa_5G","password":"una-clave-larga","security":"WPA","hidden":false,"format":"png","size":1024,"style":"rounded","eyes":"rounded","color":"#1e3a8a","eye_color":"#1e3a8a","background":"#ffffff","caption":true,"icon":"wifi","logo_size":"medium"}'
```

## Para entenderlo

- [Cómo compartir el wifi con un código QR](https://herramient.as/guias/como-compartir-wifi-con-qr): Qué lleva dentro un QR de wifi, por qué conviene la red de invitados, ideas para alojamientos, bares y oficinas, y qué hacer si el móvil no conecta.

## Preguntas frecuentes

### ¿Cómo funciona un QR de wifi?

El código guarda el nombre de la red, la contraseña y el tipo de seguridad en un formato que entienden las cámaras de iPhone y Android. Al escanearlo, el móvil ofrece conectarse a la red sin que nadie tenga que teclear la contraseña. Es lo más cómodo para bares, alojamientos turísticos, oficinas o las visitas en casa.

### ¿Dónde encuentro el nombre de la red y la contraseña?

Si nunca la has cambiado, en la pegatina que lleva el router por debajo o por detrás. El nombre tiene que ir exactamente igual que aparece en la lista de redes del móvil, respetando mayúsculas, espacios y guiones.

### Lo escaneo y no se conecta, ¿qué pasa?

Casi siempre es la contraseña: una letra en mayúscula que no lo era o un espacio de más al final. Comprueba también el tipo de seguridad: casi todos los routers actuales usan WPA2 o WPA3, que van con la opción WPA. Si la red es oculta, marca la casilla, porque el móvil no la encontrará buscándola.

### ¿Qué pasa si cambio la contraseña del wifi?

El código deja de funcionar, porque la contraseña va escrita dentro de él. Tendrás que generar uno nuevo con la contraseña nueva e imprimirlo otra vez.

### ¿Es seguro poner la contraseña en un QR?

Es igual de seguro que tenerla escrita en un papel: cualquiera que lo escanee puede leerla. Para un negocio, lo recomendable es usar la red de invitados del router y no la principal. Ten en cuenta que el código se genera en nuestro servidor y el fichero se guarda 24 horas para que puedas descargarlo; después se borra.

## 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.
- [QR de WhatsApp](https://herramient.as/qr-whatsapp): Crea un código QR que abre un chat de WhatsApp con tu número y un mensaje ya escrito.
- [QR de reseñas de Google](https://herramient.as/qr-resenas-google): Crea un código QR que lleva a tus clientes directos a dejarte una reseña en Google.
- [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.