Creación masiva de enlaces
API para crear varios enlaces cortos de una sola vez.
Si necesitas una creación masiva, también puedes usar el menú [Crear enlaces en lote] en el panel.
El número máximo de enlaces que se pueden crear de una vez según el plan es:
- Plan Personal: hasta 100
- Plan Premium: hasta 200
- Plan Business: hasta 300
Si necesitas más enlaces, deberás llamar a esta API varias veces.Esta API está disponible en planes Personales o superiores.
POST
/api/link/v1/createBulk
{
"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"
}
]
}Request Parameters
- linksarrayrequired
- Una matriz que contiene varios enlaces. Cada elemento tiene la misma estructura que la API de Creación.
- urlstringrequired
- URL original.
Se permite hasta 3,000 bytes. - domainstringrequired
- Default:https://vvd.bz
- Dominio del enlace.
Si la opción “brandLinkId” está enY, el dominio seráhttps://vvd.im.
También puedes usar un dominio personalizado. - 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. - brandLinkIdstring
- Si no se define, el ID del enlace se genera automáticamente por el sistema.
Sin un dominio personalizado, el dominio por defecto eshttps://vvd.im.
Ejemplo: https://vvd.im/[brandLinkId] - ttlstring
- Título del enlace. Si no se especifica, se usará el título de la página web del URL original.
Para acelerar la creación, define este valor directamente y evita el análisis innecesario. - descriptionstring
- Cuando
redirectTypees200, se puede establecer la metaetiqueta description. - metaImgstring
- Cuando
redirectTypees200, 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. - webhookEnableYnstring
- Default:N
- Enum:YN
- Activación del Webhook.
El Webhook global debe estar habilitado.Esta función solo está disponible en el plan Enterprise. - webhookMetricstring
- 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). - webhookFrequencyinteger
- 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. - 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": [
{
"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"
}
]
}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.
- resultarray
- Datos de respuesta. La cantidad solicitada de URLs cortas se devuelve en forma de matriz.