API de generación de QR

Crea códigos QR personalizables con una sola llamada API.

Incorpora una URL, texto o número de teléfono en el QR,
y ajusta colores, marcadores, estilos y logotipos según tu marca.

Cada QR se entrega con un enlace, listo para usar o descargar como imagen.

  • Accede al QR en https://vvd.bz/[linkId]/qr y ajusta el tamaño con el parámetro size.
  • Ejemplo: https://vvd.bz/hj7V/qr?size=500 → devuelve un QR de 500px (máx. 4096px)
POST

/api/link/v1/create/qr 

{
    "type": "url",
    "url": "https://www.youtube.com/vivoldi365",
    "domain": "https://vvd.bz",
    "logoType": "U",
    "logo": "https://example.com/images/picture/logo/500x500.png"
}

Request Parameters

domain string required
Default:https://vvd.bz
Dominio del enlace. El valor predeterminado es https://vvd.bz. Si se define brandLinkId, el dominio cambia a https://vvd.im.
Si utilizas un dominio personalizado, puedes especificarlo aquí.
type string required
Default:url
Enum:
urltextphone
Tipo de contenido del QR.
  • url: URL de página web
  • text: Texto plano
  • phone: Número de teléfono
Los campos requeridos varían según el tipo, por lo que debes enviar el valor correspondiente.
url string
URL de destino al escanear el QR. Obligatorio cuando type es url. Debe ser una URL completa con http o https.
Máximo: 2,000 bytes.
text string
Contenido de texto dentro del QR. Se usa cuando type es text y se muestra tal cual al escanear.
Útil para mensajes, códigos o instrucciones. La visualización puede variar según el dispositivo.
Máximo: 65,535 bytes.
phone string
Número de teléfono al escanear el QR. Se usa cuando type es phone. Abre la app de llamadas.
Máximo: 32 caracteres. Se recomienda incluir el código de país.
logoType string
Default:N
Enum:
NCU
Tipo de logo en el centro del QR.
  • N: Sin logo
  • C: Logo por defecto de la organización
  • U: Logo personalizado

Agregar un logo mejora el reconocimiento de marca. Disponible desde el plan Personal.

logo string
URL de la imagen del logo. Se usa cuando logoType es U. Debe ser accesible públicamente.
Se recomienda formato cuadrado y PNG transparente. Máx: 500x500 px.
foreground string
Color principal del QR (HEX). Por defecto negro.
Mantén alto contraste con el fondo.
Default: #000000FF
background string
Color de fondo (HEX). Por defecto blanco.
Fondos oscuros pueden reducir la lectura.
Default: #FFFFFFFF
markerColor string
Color de los marcadores del QR.
Default: #000000FF
markerBorderColor string
Color del borde de los marcadores.
Default: #000000FF
style string
Estilo visual del QR. Consulta el dashboard para ejemplos.
markerStyle string
Estilo de los marcadores. Compatible con múltiples formas.
grpIdx integer
ID de grupo para organización de enlaces.
brandLinkId string
Si no se define, se genera automáticamente. Dominio por defecto: https://vvd.im
ttl string
Título interno del enlace.
memo string
Nota interna no visible para usuarios.
qrBypassYn string
Y: acceso directo (sin tracking)
N: vía short link (con tracking)
pushNotifyYn string
Notificaciones push al escanear.
mailNotifyYn string
Notificaciones por email al escanear.
delYmdt datetime
Fecha de eliminación automática. 
{
    "code": 0,
    "message": "",
    "result": "https://vvd.bz/K56t"
}

Response Parameters

code integer
Código de respuesta: 0 = Éxito, otros valores = Error
message string
Mensaje de respuesta. Si el código no es 0, se devuelve un mensaje de error.
result string
Valor de respuesta. Se devuelve el enlace acortado.
Ejemplo: https://vvd.bz/jH3d

Cuándo usar esta API

Utiliza la API de generación de QR en los siguientes casos:

  • Cuando necesitas generar códigos QR a gran escala mediante integraciones con sistemas externos
  • Cuando quieres crear QR personalizados con colores y logotipos de marca vía API
  • Cuando necesitas generar QR dinámicos para productos, tarjetas o materiales impresos
  • Cuando necesitas QR para URL, texto o números de teléfono
Pensada para automatización y alto volumen, no para creación manual en el panel.

Tipos de QR

La API admite actualmente los siguientes tipos de códigos QR:

  • url: QR con URL de página web. Hasta 2.000 bytes
  • text: QR con texto plano. Hasta 65.535 bytes
  • phone: QR con número de teléfono. Hasta 32 caracteres

El panel admite otros tipos como email o WiFi, pero la API por ahora ofrece un conjunto limitado.
Se añadirán más tipos en futuras actualizaciones.

Casos de uso

La API de QR se adapta a múltiples escenarios:

  • E-commerce: Genera automáticamente un QR por producto para empaques y etiquetas
  • Tarjetas y materiales impresos: Crea QR personalizados con colores y logos de marca
  • Eventos offline: Genera códigos únicos a gran escala para entradas y acreditaciones
  • Restaurantes y tiendas: Actualiza automáticamente los QR de menús y mesas cuando cambia el contenido
Ideal para ofrecer acceso rápido y fluido en entornos móviles.

Opciones de diseño y estilo

Personaliza completamente la apariencia de tus códigos QR.

Define los colores con foreground (por defecto #000000FF), background (por defecto #FFFFFFFF), markerColor (por defecto #000000FF) y markerBorderColor (por defecto #000000).

Elige el patrón con style—rectangles, small-rectangles, dots, round, rows, columns, snakes o water—y ajusta los marcadores con markerStyle.

Añade un logo configurando logoType como U (imagen propia) o C (logo de la organización). Disponible en planes Personal o superiores.
Indica la URL en logo. Tamaño recomendado: hasta 500×500px.

Aspectos a tener en cuenta

Ten en cuenta lo siguiente al generar códigos QR:

  • Un bajo contraste de color puede reducir la precisión de lectura
  • Los diseños demasiado complejos pueden afectar el rendimiento de escaneo
  • La API actualmente solo admite un conjunto limitado de tipos de QR
Para obtener resultados fiables, comienza con la configuración predeterminada y ajústala según sea necesario.