# QR dinámico

Crea un código QR que puedes cambiar después de imprimirlo y mira cuántas veces se escanea, desde dónde y con qué móvil. Pago único por QR, sin suscripción.

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

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

## 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

### `GET /api/v1/qr/dinamicos`

Lista los QR dinámicos de tu workspace

Del más reciente al más antiguo, de 50 en 50. Incluye cuántos QR te quedan por activar.

Consume 1 unidad de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `page` | integer | no | Página, desde 1 (Ejemplo: `1`) |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `items` | array | Los QR, con los mismos campos que GET /api/v1/qr/dinamicos/:code |
| `page` | integer | La página devuelta |
| `next_page` | integer | La siguiente, o null si no hay más |
| `credits_available` | integer | QR que puedes activar sin volver a pagar |

```bash
curl -X GET https://herramient.as/api/v1/qr/dinamicos \
  -H "Authorization: Bearer htas_tu_clave_api"
```

### `POST /api/v1/qr/dinamicos`

Crea un QR dinámico

El QR funciona desde el primer momento, gratis durante 3 días. Después enseña una página de pausa hasta que se activa con POST /api/v1/qr/dinamicos/:code/activar. El destino se comprueba contra listas de webs peligrosas y se rechaza si aparece en ellas.

Consume 1 unidad de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `kind` | string | sí | El tipo de QR. Obligatorio al crear; al cambiarlo hay que mandar también el content del tipo nuevo (Ejemplo: `website`) |
| `title` | string | no | Nombre interno, hasta 120 caracteres. Por defecto, el del tipo (Ejemplo: `Cartel del escaparate`) |
| `content` | object | sí | Los campos del tipo. website: url. whatsapp: phone, message. email: to, subject, body. sms: phone, message. phone: phone. location: address o maps_url. app_link: ios_url, android_url, fallback_url. event: name, starts_at (AAAA-MM-DDTHH:MM, hora local del evento), ends_at, venue, address, description, url. vcard: first_name, last_name, organization, title, phone, email, website, street, postal_code, city. wifi: ssid, password, security (WPA, WEP, nopass). multi_link: name, description, links [{network, value, label}]. social: name, description, profiles [{network, value}]. payment: name, concept, bizum, iban, links [{value, label}]. En links y profiles, network es instagram, whatsapp, tiktok, facebook, youtube, x, linkedin, telegram, threads, spotify, pinterest, twitch, bluesky, google_maps, tripadvisor, web (por defecto web) y value es el usuario (@mibar), el teléfono para whatsapp o la dirección entera; se guarda la dirección final en url. feedback: name, question, review_link. pdf, image: title, description. video: title, description, video_url. Los tipos con fichero (pdf, image, video, vcard, multi_link) lo reciben como multipart en files[pdf], files[images][], files[video], files[photo] o files[avatar] (Ejemplo: `{"url"=>"https://mibar.es/carta"}`) |
| `design` | object | no | style (square, rounded, dots), eyes (square, rounded, circle), color, background y eye_color en hexadecimal, icon (wifi, whatsapp, star, contact), logo_size (small, medium, large) y caption (true o false) (Ejemplo: `{"style"=>"rounded", "color"=>"#1e3a8a"}`) |
| `files[logo]` | file | no | Tu logo para el centro del QR, como multipart: PNG, JPG o WebP de hasta 5 MB. Con logo se ignora icon |
| `remove_logo` | boolean | no | true para quitar el logo que ya tiene el QR (Ejemplo: `false`) |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `code` | string | El código público, el que va en la dirección corta. No cambia nunca |
| `short_url` | string | Lo que va dentro del QR impreso: https://qr.herramient.as/<code> |
| `kind` | string | El tipo de QR |
| `title` | string | Nombre interno del QR; solo lo ve su dueño |
| `content` | object | Los campos del tipo, ya validados y normalizados (teléfonos con prefijo, webs con https) |
| `design` | object | El aspecto: style, eyes, color, background, eye_color, icon, caption |
| `files` | object | Ficheros subidos por papel (pdf, images, photo, avatar, video), con nombre, tipo y tamaño |
| `status` | string | trial hasta que se activa con un crédito |
| `serving` | string | Qué ve ahora mismo quien lo escanea |
| `trial_ends_at` | string | Fin de la prueba gratuita, si está en prueba |
| `activated_at` | string | Cuándo se activó para siempre |
| `scans_count` | integer | Escaneos de personas desde siempre, sin las vistas previas automáticas |
| `last_scanned_at` | string | Último escaneo |
| `manage_url` | string | Su página en herramient.as, con estadísticas y el botón de pago |
| `image_url` | string | El endpoint que devuelve la imagen del QR |

**Errores**

- `422`: Un campo no es válido o falta uno obligatorio; code dice cuál es el problema y field, el campo

```bash
curl -X POST https://herramient.as/api/v1/qr/dinamicos \
  -H "Authorization: Bearer htas_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{"kind":"website","title":"Cartel del escaparate","content":{"url":"https://mibar.es/carta"},"design":{"style":"rounded","color":"#1e3a8a"},"remove_logo":false}'
```

### `GET /api/v1/qr/dinamicos/:code`

Consulta un QR dinámico

Consume 1 unidad de cuota.

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `code` | string | El código público, el que va en la dirección corta. No cambia nunca |
| `short_url` | string | Lo que va dentro del QR impreso: https://qr.herramient.as/<code> |
| `kind` | string | El tipo de QR |
| `title` | string | Nombre interno del QR; solo lo ve su dueño |
| `content` | object | Los campos del tipo, ya validados y normalizados (teléfonos con prefijo, webs con https) |
| `design` | object | El aspecto: style, eyes, color, background, eye_color, icon, caption |
| `files` | object | Ficheros subidos por papel (pdf, images, photo, avatar, video), con nombre, tipo y tamaño |
| `status` | string | trial hasta que se activa con un crédito |
| `serving` | string | Qué ve ahora mismo quien lo escanea |
| `trial_ends_at` | string | Fin de la prueba gratuita, si está en prueba |
| `activated_at` | string | Cuándo se activó para siempre |
| `scans_count` | integer | Escaneos de personas desde siempre, sin las vistas previas automáticas |
| `last_scanned_at` | string | Último escaneo |
| `manage_url` | string | Su página en herramient.as, con estadísticas y el botón de pago |
| `image_url` | string | El endpoint que devuelve la imagen del QR |

**Errores**

- `404`: No existe un QR dinámico con ese código en tu workspace

```bash
curl -X GET https://herramient.as/api/v1/qr/dinamicos/:code \
  -H "Authorization: Bearer htas_tu_clave_api"
```

### `PATCH /api/v1/qr/dinamicos/:code`

Cambia el destino, el tipo o el diseño de un QR dinámico

Lo que no se manda se queda como está. El código y la dirección corta no cambian, así que el QR impreso sigue valiendo y quien lo escanee ve lo nuevo al momento.

Consume 1 unidad de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `kind` | string | no | El tipo de QR. Obligatorio al crear; al cambiarlo hay que mandar también el content del tipo nuevo (Ejemplo: `website`) |
| `title` | string | no | Nombre interno, hasta 120 caracteres. Por defecto, el del tipo (Ejemplo: `Cartel del escaparate`) |
| `content` | object | no | Los campos del tipo. website: url. whatsapp: phone, message. email: to, subject, body. sms: phone, message. phone: phone. location: address o maps_url. app_link: ios_url, android_url, fallback_url. event: name, starts_at (AAAA-MM-DDTHH:MM, hora local del evento), ends_at, venue, address, description, url. vcard: first_name, last_name, organization, title, phone, email, website, street, postal_code, city. wifi: ssid, password, security (WPA, WEP, nopass). multi_link: name, description, links [{network, value, label}]. social: name, description, profiles [{network, value}]. payment: name, concept, bizum, iban, links [{value, label}]. En links y profiles, network es instagram, whatsapp, tiktok, facebook, youtube, x, linkedin, telegram, threads, spotify, pinterest, twitch, bluesky, google_maps, tripadvisor, web (por defecto web) y value es el usuario (@mibar), el teléfono para whatsapp o la dirección entera; se guarda la dirección final en url. feedback: name, question, review_link. pdf, image: title, description. video: title, description, video_url. Los tipos con fichero (pdf, image, video, vcard, multi_link) lo reciben como multipart en files[pdf], files[images][], files[video], files[photo] o files[avatar] (Ejemplo: `{"url"=>"https://mibar.es/carta"}`) |
| `design` | object | no | style (square, rounded, dots), eyes (square, rounded, circle), color, background y eye_color en hexadecimal, icon (wifi, whatsapp, star, contact), logo_size (small, medium, large) y caption (true o false) (Ejemplo: `{"style"=>"rounded", "color"=>"#1e3a8a"}`) |
| `files[logo]` | file | no | Tu logo para el centro del QR, como multipart: PNG, JPG o WebP de hasta 5 MB. Con logo se ignora icon |
| `remove_logo` | boolean | no | true para quitar el logo que ya tiene el QR (Ejemplo: `false`) |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `code` | string | El código público, el que va en la dirección corta. No cambia nunca |
| `short_url` | string | Lo que va dentro del QR impreso: https://qr.herramient.as/<code> |
| `kind` | string | El tipo de QR |
| `title` | string | Nombre interno del QR; solo lo ve su dueño |
| `content` | object | Los campos del tipo, ya validados y normalizados (teléfonos con prefijo, webs con https) |
| `design` | object | El aspecto: style, eyes, color, background, eye_color, icon, caption |
| `files` | object | Ficheros subidos por papel (pdf, images, photo, avatar, video), con nombre, tipo y tamaño |
| `status` | string | trial hasta que se activa con un crédito |
| `serving` | string | Qué ve ahora mismo quien lo escanea |
| `trial_ends_at` | string | Fin de la prueba gratuita, si está en prueba |
| `activated_at` | string | Cuándo se activó para siempre |
| `scans_count` | integer | Escaneos de personas desde siempre, sin las vistas previas automáticas |
| `last_scanned_at` | string | Último escaneo |
| `manage_url` | string | Su página en herramient.as, con estadísticas y el botón de pago |
| `image_url` | string | El endpoint que devuelve la imagen del QR |

**Errores**

- `404`: No existe un QR dinámico con ese código en tu workspace
- `422`: Un campo no es válido o falta uno obligatorio; code dice cuál es el problema y field, el campo

```bash
curl -X PATCH https://herramient.as/api/v1/qr/dinamicos/:code \
  -H "Authorization: Bearer htas_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{"kind":"website","title":"Cartel del escaparate","content":{"url":"https://mibar.es/carta"},"design":{"style":"rounded","color":"#1e3a8a"},"remove_logo":false}'
```

### `POST /api/v1/qr/dinamicos/:code/activar`

Activa un QR dinámico para siempre con uno de tus créditos

Gasta un crédito de los que compraste (pago único, sin suscripción). Activar un QR que ya está activo no gasta otro. Los créditos se compran en la web, con tarjeta: sin créditos la respuesta es un 402 con checkout_url, la página donde una persona puede pagarlo.

No consume cuota.

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `code` | string | El código público, el que va en la dirección corta. No cambia nunca |
| `short_url` | string | Lo que va dentro del QR impreso: https://qr.herramient.as/<code> |
| `kind` | string | El tipo de QR |
| `title` | string | Nombre interno del QR; solo lo ve su dueño |
| `content` | object | Los campos del tipo, ya validados y normalizados (teléfonos con prefijo, webs con https) |
| `design` | object | El aspecto: style, eyes, color, background, eye_color, icon, caption |
| `files` | object | Ficheros subidos por papel (pdf, images, photo, avatar, video), con nombre, tipo y tamaño |
| `status` | string | trial hasta que se activa con un crédito |
| `serving` | string | Qué ve ahora mismo quien lo escanea |
| `trial_ends_at` | string | Fin de la prueba gratuita, si está en prueba |
| `activated_at` | string | Cuándo se activó para siempre |
| `scans_count` | integer | Escaneos de personas desde siempre, sin las vistas previas automáticas |
| `last_scanned_at` | string | Último escaneo |
| `manage_url` | string | Su página en herramient.as, con estadísticas y el botón de pago |
| `image_url` | string | El endpoint que devuelve la imagen del QR |

**Errores**

- `404`: No existe un QR dinámico con ese código en tu workspace
- `402`: No te quedan créditos. checkout_url lleva a la página de pago de este QR
- `403`: El QR está desactivado tras una denuncia

```bash
curl -X POST https://herramient.as/api/v1/qr/dinamicos/:code/activar \
  -H "Authorization: Bearer htas_tu_clave_api"
```

### `GET /api/v1/qr/dinamicos/:code/estadisticas`

Estadísticas de escaneos de un QR dinámico

Agrupadas por día y hora (hora de España), país, ciudad, dispositivo, sistema y navegador. Las vistas previas automáticas (WhatsApp, Slack...) se cuentan aparte en bot_scans. No guardamos la IP de quien escanea: no hay datos por persona que consultar.

Consume 1 unidad de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `from` | string | no | Primer día, AAAA-MM-DD. Por defecto, hace 30 días (Ejemplo: `2026-11-01`) |
| `to` | string | no | Último día, incluido. Por defecto, hoy. Como mucho un año de rango (Ejemplo: `2026-11-30`) |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `total_scans` | integer | Escaneos de personas en el periodo |
| `unique_visitors` | integer | Visitantes distintos, contados por día |
| `bot_scans` | integer | Vistas previas automáticas, que no entran en el resto de cifras |
| `all_time_scans` | integer | Escaneos de personas desde siempre |
| `by_day` | array | Un elemento por día del periodo: date, scans |
| `by_hour` | array | 24 elementos: hour, scans |
| `countries` | array | Los 10 primeros: value (código ISO), label, scans |
| `unknown_country_scans` | integer | Escaneos de los que no se sabe el país (IP privada o desconocida) |
| `unknown_city_scans` | integer | Escaneos de los que no se sabe la ciudad |
| `cities` | array | Las 10 primeras: value, scans |
| `devices` | array | mobile, tablet, desktop u other, con scans |
| `operating_systems` | array | value, scans |
| `browsers` | array | value, scans |

**Errores**

- `404`: No existe un QR dinámico con ese código en tu workspace
- `400`: Las fechas no son válidas o from es posterior a to

```bash
curl -X GET https://herramient.as/api/v1/qr/dinamicos/:code/estadisticas \
  -H "Authorization: Bearer htas_tu_clave_api"
```

### `GET /api/v1/qr/dinamicos/:code/imagen`

Descarga la imagen de un QR dinámico

Responde con los bytes de la imagen, dibujada con el diseño guardado. Siempre la misma mientras no cambies el diseño: el contenido de un QR dinámico es su dirección corta, que no cambia.

Consume 3 unidades de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `format` | string | no | Por defecto png (Ejemplo: `png`) |
| `size` | integer | no | Ancho en píxeles. Por defecto 1024 (Ejemplo: `1024`) |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `(binario)` | string | La imagen, con Content-Type image/png o image/svg+xml |

**Errores**

- `404`: No existe un QR dinámico con ese código en tu workspace
- `400`: El formato o el tamaño no son válidos

```bash
curl -X GET https://herramient.as/api/v1/qr/dinamicos/:code/imagen \
  -H "Authorization: Bearer htas_tu_clave_api"
```

## Para entenderlo

- [QR dinámico o estático: cuál necesitas](https://herramient.as/guias/qr-dinamico-o-estatico): Qué lleva dentro cada uno, qué puedes cambiar después de imprimir, qué pasa si dejas de pagar y en qué casos te basta con el gratuito.

## Preguntas frecuentes

### ¿Qué diferencia hay entre un QR estático y uno dinámico?

Un QR estático lleva los datos escritos dentro del propio código: si cambias de web o de carta, hay que imprimir otro. Uno dinámico lleva una dirección corta nuestra (qr.herramient.as/...) que redirige a donde tú digas, así que puedes cambiar el destino, el tipo o el contenido cuando quieras sin tocar lo impreso, y además ves cuántas veces se escanea.

### ¿Cuánto cuesta y qué pasa si no pago?

Crear el QR y probarlo es gratis durante 3 días, con el código funcionando de verdad. Para que siga funcionando se paga una sola vez por QR, sin suscripción, y hay paquetes con descuento si necesitas varios. Si no pagas, el código no da error: enseña un aviso de que está en pausa, y lo puedes activar cuando quieras.

### ¿De verdad es para siempre?

Sí: un pago y el QR queda activo sin renovaciones ni cuotas, con sus cambios y sus estadísticas incluidos. Mientras herramient.as exista, tu código funciona. Si algún día cerráramos, lo avisaríamos con tiempo y te daríamos a dónde apunta cada uno para que no pierdas nada.

### ¿Qué datos guardáis de quien escanea?

Lo mínimo para darte estadísticas útiles: la fecha y hora, el país y la ciudad aproximados, y el tipo de móvil. No guardamos la dirección IP de nadie ni ponemos cookies en la página del QR, así que no hace falta banner de consentimiento. Las vistas previas automáticas de WhatsApp o Slack se separan para que no inflen tus cifras.

### ¿Puedo cambiar el tipo de QR después de imprimirlo?

Sí. El código impreso no cambia nunca; lo que cambia es lo que hay detrás. Un QR que hoy abre tu web puede llevar mañana a un PDF con la carta o a una lista con tus redes, sin reimprimir nada.

### ¿Lo puedo crear desde mi programa o con un asistente de IA?

Sí. Hay una API para crear, cambiar y consultar las estadísticas de tus QR dinámicos con tu clave, y la misma API se puede conectar a asistentes como Claude o ChatGPT para que lo hagan por ti.

## 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.
- [QR de tarjeta de contacto](https://herramient.as/qr-tarjeta-contacto): Crea un código QR con tus datos de contacto (vCard) para que te guarden en la agenda con un toque.
