Developer API

Creación masiva de enlaces

Esta API permite crear varios enlaces cortos a la vez.
Para una creación masiva, utiliza el menú “Crear enlaces en lote” en el panel de control.

La cantidad de enlaces que se pueden generar por solicitud varía según el plan.
Para generar más, debes dividir la operación en varias llamadas a la API.

Plan Personal: Hasta 100 enlaces
Plan Premium: Hasta 200 enlaces
Plan Business: Hasta 300 enlaces

Esta API está disponible a partir del plan Personal.

Http Header

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

Request

{
	"links": [
		{
			"url": "https://google.com",
			"domain": "https://vvd.bz"
		},
		{
			"url": "https://facebook.com",
			"domain": "https://vvd.bz"
		},
		{
			"url": "https://twitter.com",
			"domain": "https://vvd.bz"
		}
	]
}

Campos

Tipo

links

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

array

Response

{
	"code": 0,
	"message": "",
	"result": [
		{
			"shortUrl": "https://vvd.bz/bbuR",
			"url": "https://google.com"
		},
		{
			"shortUrl": "https://vvd.bz/bbuS",
			"url": "https://facebook.com"
		},
		{
			"shortUrl": "https://vvd.bz/bbuT",
			"url": "https://twitter.com"
		}
	]
}

Campos	Descripción	Tipo
code	Código de respuesta. `0` indica éxito; cualquier otro valor indica error.	int
message	Mensaje de respuesta. Se incluye solo si `code` no es 0 e indica el error.	string
result	Datos de respuesta. Devuelve una lista de URLs cortas generadas según la cantidad solicitada.	array