Crear enlace

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.

reuseYnstring

Predeterminado:N

Enum:

YN

Indica si se reutiliza una URL existente.
Y: Si ya existe la misma URL larga, no se crea una nueva y se devuelve la primera URL corta generada.
N: Siempre se genera una nueva URL corta.

Esta opción se usa para evitar duplicados de URL largas o reutilizar enlaces existentes.
Esta función está disponible solo en planes Premium 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.

qrBypassYnstring

Predeterminado:N

Enum:

YN

Controla si se debe omitir el enlace corto al escanear un código QR y acceder directamente a la URL original configurada por el usuario.
Y: Redirige directamente a la URL original sin pasar por el enlace corto. (No se registran estadísticas de escaneo QR)
N: Pasa por el enlace corto antes de redirigir a la URL original. (Se registran estadísticas de escaneo QR)

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.

webhookEnableYnstring

Default:N

Enum:

YN

Activación del Webhook.
El Webhook global debe estar habilitado.
Esta función solo está disponible en el plan Enterprise.

webhookMetricstring

Default:C

Enum:

CP

Criterio de recepción del Webhook.
C: Según número de clics, P: Según número de usuarios únicos (clics únicos).

webhookFrequencyinteger

Default:1

Enum:

1501002003005001000

Frecuencia de recepción del Webhook.
1: En cada clic, 50: Cada 50 clics, 100: Cada 100 clics, 300: Cada 300 clics, 500: Cada 500 clics, 1000: Cada 1.000 clics.

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