Editar enlace

API para modificar la información de una URL corta generada.

Solo se permite cuando el tipo de enlace es URL. Otros tipos (Enlace de Publicación, Enlace de Formulario, Enlace de Botón, etc.) no se actualizarán aunque se llame a la API.

PUT

/api/link/v2/update 

{
    "linkId": "4Rt3",
    "domain": "https://vvd.bz",
    "ttl": "new title",
    "memo": "new my memo"
}

Request Parameters

linkIdstringrequired
ID del enlace.
Si la URL es “https://vvd.bz/fML”, el ID del enlace es fML.
domainstringrequired
Default:https://vvd.bz
Dominio del enlace.
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.
urlstring
URL original. Se permiten hasta 3.000 bytes.
Esta función está disponible en planes Premium o superiores.
ttlstring
Título del enlace.
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.
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 
{
    "code": 0,
    "message": "",
    "result": null
}

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