API de creación de enlaces

Request Parameters

url string required

URL original.
Se permite hasta 3,000 bytes.

domain string required

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.

redirectType integer

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.

reuseYn string

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.

grpIdx integer

Se utiliza para agrupar enlaces.
El IDX de grupo puede obtenerse mediante la API de Lista de Grupos o en el panel.

brandLinkId string

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]

ttl string

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.

description string

Cuando redirectType es 200, se puede establecer la metaetiqueta description.

metaImg string

Cuando redirectType es 200, se puede establecer la metaetiqueta image.
La URL de la imagen debe comenzar con https://.

memo string

Nota para la gestión del enlace.

notfSubscYn string

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.

qrBypassYn string

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)

pushNotifyYn string

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.

mailNotifyYn string

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.

webhookEnableYn string

Default:N

Enum:

YN

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

webhookMetric string

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

webhookFrequency integer

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.

delYmdt datetime

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