Crear enlace

Esta es la API básica para crear enlaces cortos.

Para generar varios enlaces a la vez, usa la Bulk Create API o el menú [Crear enlaces en lote] en el panel.

Cada enlace corto genera automáticamente un código QR.

  • Los códigos QR están disponibles en https://vvd.bz/[linkId]/qr, y puedes ajustar el tamaño con el parámetro size.
  • Ejemplo: https://vvd.bz/hj7V/qr?size=200 → Devuelve un código QR de 200px.
POST

/api/link/v2/create 

{
    "url": "https://www.facebook.com/vivoldi365",
    "domain": "https://vvd.bz"
}

Request Parameters

urlstringrequired
URL original.
Se permite hasta 3,000 bytes.
domainstringrequired
Default:https://vvd.bz
Dominio del enlace.
Si la opción “brandLinkId” está en Y, el dominio será https://vvd.im.
También puedes usar un dominio personalizado.
redirectTypeinteger
Default:302
Enum:
200301302
Tipo de redirección.
Consulta la página de Términos para más detalles.
Esta función está disponible en planes Personales o superiores.
grpIdxinteger
Se utiliza para agrupar enlaces.
El IDX de grupo puede obtenerse mediante la API de Lista de Grupos o en el panel.
brandLinkIdstring
Si no se define, el ID del enlace se genera automáticamente por el sistema.
Sin un dominio personalizado, el dominio por defecto es https://vvd.im.
Ejemplo: https://vvd.im/[brandLinkId]
ttlstring
Título del enlace. Si no se especifica, se usará el título de la página web del URL original.
Para acelerar la creación, define este valor directamente y evita el análisis innecesario.
descriptionstring
Cuando redirectType es 200, se puede establecer la metaetiqueta description.
metaImgstring
Cuando redirectType es 200, se puede establecer la metaetiqueta image.
La URL de la imagen debe comenzar con https://.
memostring
Nota para la gestión del enlace.
notfSubscYnstring
Default:N
Enum:
YN
Indica si es un enlace de suscripción push.
Si es Y, se abre una página de aterrizaje antes de redirigir al URL original para solicitar permiso de notificación.
Si el usuario rechaza o cancela, será redirigido inmediatamente al URL original.
pushNotifyYnstring
Default:N
Enum:
YN
Notificaciones push de clics.
Si es Y, se enviarán alertas a los dispositivos con la app de Vivoldi cuando se alcance el número configurado de clics (en Panel → Configuración).
Esta función está disponible en planes Personales o superiores.
mailNotifyYnstring
Default:N
Enum:
YN
Notificaciones por correo de clics.
Si es Y, se enviarán correos electrónicos cada vez que se alcance el número configurado de clics (en Panel → Configuración).
Esta función está disponible en planes Personales o superiores.
delYmdtdatetime
Fecha programada de eliminación del enlace.
Una vez pasada la fecha, el enlace se elimina automáticamente.
Ejemplo: 2025-08-30 23:59:59 
{
    "code": 0,
    "message": "",
    "result": "https://vvd.bz/jH3d"
}

Response Parameters

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