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
es200
, se puede establecer la metaetiqueta description. - metaImgstring
- Cuando
redirectType
es200
, se puede establecer la metaetiqueta image.
La URL de la imagen debe comenzar conhttps://
. - memostring
- Nota para la gestión del enlace.
- notfSubscYnstring
- 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. - pushNotifyYnstring
- 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.
- mailNotifyYnstring
- 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.
- 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