# QR de tarjeta de contacto

Crea un código QR con tus datos de contacto (vCard) para que te guarden en la agenda con un toque.

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

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

## 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/vcard`

Genera un código QR con una tarjeta de contacto (vCard 3.0)

Compone una vCard 3.0 con los campos escapados y el teléfono en formato internacional. Hacen falta el nombre y al menos un teléfono o un correo.

Consume 3 unidades de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `first_name` | string | sí | Nombre (Ejemplo: `Lucía`) |
| `last_name` | string | no | Apellidos (Ejemplo: `García Pérez`) |
| `organization` | string | no | Empresa (Ejemplo: `Panadería La Espiga`) |
| `title` | string | no | Cargo (Ejemplo: `Gerente`) |
| `phone` | string | no | Teléfono. Sin prefijo se entiende español (Ejemplo: `600 12 34 56`) |
| `email` | string | no | Correo electrónico (Ejemplo: `lucia@example.com`) |
| `website` | string | no | Web (Ejemplo: `https://example.com`) |
| `street` | string | no | Dirección (Ejemplo: `Calle Mayor 1`) |
| `postal_code` | string | no | Código postal (Ejemplo: `28013`) |
| `city` | string | no | Ciudad (Ejemplo: `Madrid`) |
| `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/vcard \
  -H "Authorization: Bearer htas_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Lucía","last_name":"García Pérez","organization":"Panadería La Espiga","title":"Gerente","phone":"600 12 34 56","email":"lucia@example.com","website":"https://example.com","street":"Calle Mayor 1","postal_code":"28013","city":"Madrid","format":"png","size":1024,"style":"rounded","eyes":"rounded","color":"#1e3a8a","eye_color":"#1e3a8a","background":"#ffffff","caption":true,"icon":"wifi","logo_size":"medium"}'
```

## Preguntas frecuentes

### ¿Qué es un QR de tarjeta de contacto?

Un código con tus datos en formato vCard, el estándar de las agendas. Al escanearlo, el móvil ofrece guardar el contacto con tu nombre, teléfono, correo, empresa y dirección ya rellenos. Es perfecto para tarjetas de visita, ferias o la firma de un presupuesto.

### ¿Funciona en iPhone y Android?

Sí. Usamos la versión 3.0 de vCard, que es la que leen sin problemas las cámaras de iPhone y Android y también Outlook. Si un móvil antiguo no lo abre, una app lectora de QR lo resolverá.

### ¿Qué datos debo poner?

El nombre y al menos un teléfono o un correo. Lo demás es opcional, pero cuanto menos pongas, más pequeño y fácil de escanear sale el código. En una tarjeta impresa pequeña, quédate con lo esencial.

### Si cambio de teléfono, ¿tengo que hacer otro?

Sí. Los datos van escritos dentro del código, no en un enlace que podamos actualizar, así que un cambio supone generar e imprimir uno nuevo. A cambio, el código funciona para siempre y no depende de ningún servicio.

### ¿Guardáis mis datos?

El código se genera en nuestro servidor y el fichero se guarda 24 horas para que puedas descargarlo; después se borra. No usamos los datos para nada más.

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