API de actualización de enlaces

Actualiza enlaces existentes sin cambiar su ID.

Modifica la URL de destino, la redirección, la vista previa y las notificaciones manteniendo el mismo linkId.

Solo disponible para enlaces de tipo URL. Los enlaces de formulario, botón u otros tipos no se pueden editar con esta 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 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 
{
    "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

Cuándo usar esta API

Utiliza esta API en situaciones como estas:

  • Actualizar la URL de destino de un enlace corto existente
  • Modificar redirección, expiración, notas u otros ajustes
  • Editar un enlace en uso sin eliminarlo ni reemplazarlo
  • Ajustar webhooks, notificaciones o integraciones después del lanzamiento
El enlace se mantiene intacto, por lo que puedes actualizar el contenido sin afectar los enlaces ya compartidos.

Diferencias con la API de creación

Misma estructura, distinto objetivo.

  • linkId y domain son obligatorios para identificar el enlace exacto
  • Modifica solo los campos necesarios
  • Las estadísticas y datos existentes se mantienen
  • Cambiar la url está disponible en planes premium o superiores
  • Los enlaces que no son de tipo URL, como formularios o botones, no son compatibles
Usa esta API para ajustar configuraciones sin crear un nuevo enlace.

Casos de uso

Control total sobre enlaces ya publicados.

  • E-commerce: Actualiza dinámicamente la URL de destino según el stock o la disponibilidad
  • Publicidad: Mantén el mismo enlace mientras cambias la landing según la temporada
  • Operaciones: Redirige al instante a una página alternativa en caso de incidencias
  • Actualiza títulos e imágenes de vista previa en redes sociales
Ideal para actualizar contenido sin romper enlaces ya compartidos.

Aspectos a tener en cuenta

Ten en cuenta estos puntos antes de realizar cambios.

  • Actualizar la URL de destino puede afectar la experiencia del usuario
  • Una configuración incorrecta puede alterar el comportamiento del enlace
  • Si notfSubscYn está en Y, los suscriptores serán notificados antes del cambio. La notificación no se puede cancelar una vez enviada.
  • Los enlaces eliminados no pueden restaurarse con esta API
Revisa la configuración actual antes de aplicar cambios.