Editar enlace
Esta API se utiliza para modificar la información de una URL acortada ya creada.
Solo se permiten modificaciones si el tipo de enlace es URL.
Para otros tipos (como enlaces de publicación, formularios, botones o tarjetas), las solicitudes de actualización serán ignoradas y no se aplicarán cambios.
Http Header
PUT /api/link/v2/update
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: application/json
User-agent: {Your User-agent}
Accept-Language: en
Request
{
"linkId": "4Rt3",
"domain": "https://vvd.bz",
"ttl": "new title",
"memo": "new my memo"
}| Campos | Descripción de los campos | Descripción | Requerido | Tipo |
|---|---|---|---|---|
| linkId | ID de enlace | ID del enlace corto generado. Ejemplo: Si la dirección del enlace corto es "https://vvd.bz/fML", el ID de enlace es fML. | string | |
| domain | Dominio | El dominio de la dirección del enlace corto. Ejemplo: Si la dirección del enlace corto es "https://vvd.bz/fML", el dominio es https://vvd.bz. Importante: Debes ingresar https:// o http://. Si configuras un dominio diferente al del enlace generado, se producirá un error. | string | |
| redirectType | Tipo de redirección | Define cómo se navega del enlace corto a la URL larga. Puedes elegir entre 200, 301 o 302 como código de estado HTTP. Valor predeterminado: 302. Para más información sobre métodos de redirección, consulta la página de “Glosario”. | int | |
| grpIdx | ID de grupo | Cambia el grupo del enlace generado. Para obtener el ID de grupo, debes llamar a la API "Lista de grupos". | int | |
| url | URL larga | Cambia la URL larga. Solo puedes cambiar URLs largas a partir del plan Premium. | string | |
| ttl | Título del enlace | Si este campo está vacío, el título del enlace no se modifica. | string | |
| description | Meta descripción | Puedes definir la meta description de la página cuando “redirectType” tenga valor “200”. Este valor se ignora cuando “redirectType” es “301”, “302”, etc. | string | |
| metaImg | Meta imagen | Solo puede establecer la etiqueta meta imagen cuando el valor de redirectType es «200». El valor de la meta imagen debe estar en formato URL y comenzar por «https://». Si redirectType es «301» o «302», el valor se ignora. | string | |
| memo | Notas | Puedes añadir información administrativa adicional que no será visible para los usuarios. Si este campo está vacío, la nota no se modificará. | string | |
| notfSubscYn | Enlace Push | Si el valor es Y, al hacer clic en el enlace se mostrará un pop-up de notificación push antes de ir a la URL larga. Si el usuario ha aceptado las notificaciones push, puedes enviar mensajes push a todos los usuarios permitidos. Si rechazan o cierran el pop-up, irán directamente a la URL larga. Si no ingresas un valor, el valor predeterminado es N. Para saber más sobre enlaces de suscripción push, haz clic aquí. | Y o N | |
| pushNotifyYn | Notificaciones push | Si el valor es Y, recibirás notificaciones push en dispositivos móviles con la app Vivoldi instalada cada vez que un enlace alcance el número de clics configurado en "Configuración -> Preferencias". Esta función está disponible a partir del plan Personal. | Y o N | |
| mailNotifyYn | Notificaciones por correo | Si el valor es Y, recibirás información por correo sobre el número de clics cada vez que se alcance el objetivo configurado en "Configuración -> Preferencias". Esta función está disponible a partir del plan Personal. | Y o N | |
| delYmd | Fecha de eliminación | Después de la fecha indicada, el enlace se eliminará automáticamente. Ciclo de eliminación: cada hora. Ejemplo: 2025-12-31 | Date |
Response
{
"code": 0,
"message": "",
"result": null
}
| Campos | Descripción | Tipo |
|---|---|---|
| code | Código de respuesta (0:Éxito) | int |
| message | El mensaje de respuesta, o un mensaje relacionado si el código de respuesta es distinto de cero. | string |