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
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": [
{
"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.