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
- linkId string required
-
ID del enlace.
Si la URL es “https://vvd.bz/fML”, el ID del enlace es fML. - domain string required
- Default:https://vvd.bz
- Dominio del enlace.
- 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. - grpIdx integer
-
Se utiliza para agrupar enlaces.
El IDX de grupo puede obtenerse mediante la API de Lista de Grupos o en el panel. - url string
-
URL original. Se permiten hasta 3.000 bytes.
Esta función está disponible en planes Premium o superiores. - ttl string
- Título del enlace.
- description string
-
Cuando
redirectTypees200, se puede establecer la metaetiqueta description. - metaImg string
-
Cuando
redirectTypees200, se puede establecer la metaetiqueta image.
La URL de la imagen debe comenzar conhttps://. - 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 esY, 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 esY, 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 esY, 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
{
"code": 0,
"message": "",
"result": null
}
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 null