Developer API

Crear enlace

Esta API genera una URL corta.
Para crear varios enlaces al mismo tiempo, utiliza la API de “Creación masiva”.
También puedes generar enlaces rápidamente desde el menú “Crear enlaces en lote” en el panel.

Se genera automáticamente un código QR para cada enlace corto.
Puedes acceder al código QR con el siguiente formato de URL:
vvd.bz/[linkId]/qr

Para ajustar el tamaño del código QR, añade el parámetro size.
Ejemplo: vvd.bz/[linkId]/qr?size=200 → devuelve un código QR de 200 píxeles

Http Header

POST /api/link/v2/create
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: application/json
User-agent: {Your User-agent}
Accept-Language: en

Request

{
	"url": "https://www.facebook.com/vivoldi365",
	"domain": "https://vvd.bz"
}

Campos	Descripción de los campos	Descripción	Tipo
url	URL larga	La URL larga a la que se redirigirá cuando se haga clic en el enlace corto generado. Puede tener hasta 3,000 bytes.	string
domain	Dominio	Si el valor está vacío, se establecerá automáticamente como el dominio vvd.bz. Debes ingresar el valor incluyendo “https://” y, si la opción “brandLinkId” es “Y”, utiliza el dominio “https://vvd.im”. Si has vinculado tu propio dominio a Vivoldi, puedes configurarlo aquí. Ejemplo: https://vvd.bz	string
redirectType	Tipo de redirección	Establece cómo se navega desde la URL corta a la URL larga. Puedes elegir entre 200, 301 o 302 como el código de respuesta HTTP. Valor predeterminado: 302 Para más información sobre los métodos de redirección, consulta la página de “Glosario”.	int
grpIdx	ID de grupo	Asignar un ID de grupo vinculará el enlace a ese grupo. Para obtener el GroupID, debes usar la API de "Lista de grupos".	int
brandLinkId	ID de enlace de marca	Si especificas un valor, el enlace se creará con ese ID. (Si se establece un enlace de marca, el dominio será vvd.im en vez de vvd.bz) Si el valor está vacío, el linkID se genera automáticamente.	string
ttl	Título del enlace	Si el valor está vacío, se almacenará como el título de la página web de la URL larga. Si está vacío, se accede a la URL larga y se realiza un análisis HTML, por lo que si la respuesta es lenta tras llamar a la API, asigna el título.	string
description	Meta descripción	Puedes definir la meta description de la página cuando “redirectType” sea “200”. Este valor se ignora si “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 adicional para gestión interna que no será visible para los usuarios.	string
notfSubscYn	Enlace push	Si el valor es Y, al hacer clic en el enlace generado, aparecerá una ventana emergente de notificación push antes de acceder al enlace largo, y podrás enviar mensajes push a todos los usuarios que hayan dado permiso. Si el usuario rechaza o cierra la ventana, será dirigido inmediatamente a la URL larga. Si no se ingresa valor, el predeterminado es N. Para más información, consulta la página de introducción de Web Push.	Y o N
pushNotifyYn	Notificaciones push	Si el valor es Y, recibirás notificaciones push en dispositivos móviles con la app de Vivoldi instalada, cada vez que se alcance el número de clics configurado en las preferencias del enlace. Disponible a partir del plan Personal.	Y o N
mailNotifyYn	Notificaciones por correo	Si el valor es Y, recibirás información por correo cada vez que el enlace alcance el número de clics definido en las preferencias. Disponible a partir del plan Personal.	Y o N
delYmd	Fecha de eliminación	Tras la fecha configurada, el enlace se elimina automáticamente. Ciclo de eliminación: cada hora Ejemplo: 2025-12-31	Date

Response

{
	"code": 0,
	"message": "",
	"result": "https://vvd.bz/jH3d"
}

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
result	Valor de la respuesta (enlace acortado)	string