Création de liens en masse

API pour créer plusieurs liens courts en une seule fois.
Pour une création en masse, vous pouvez également utiliser le menu [Créer des liens en masse] dans le tableau de bord.

Le nombre maximum de liens pouvant être créés en une seule fois selon le forfait est :

  • Forfait Personnel : jusqu’à 100
  • Forfait Premium : jusqu’à 200
  • Forfait Business : jusqu’à 300

Si vous avez besoin de plus de liens, appelez cette API plusieurs fois.
Cette API est disponible à partir du forfait Personnel.

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
Un tableau contenant plusieurs liens. Chaque élément a la même structure que l’API de Création.
urlstringrequired
URL d’origine.
Jusqu’à 3 000 octets sont autorisés.
domainstringrequired
Default:https://vvd.bz
Domaine du lien.
Si l’option « brandLinkId » est définie sur Y, le domaine sera https://vvd.im.
Un domaine personnalisé peut également être utilisé.
redirectTypeinteger
Default:302
Enum:
200301302
Type de redirection.
Voir la page Terminologie pour plus de détails.
Cette fonctionnalité est disponible à partir du forfait Personnel.
grpIdxinteger
Utilisé pour regrouper les liens.
L’IDX de groupe peut être obtenu via l’API Liste de Groupes ou depuis le tableau de bord.
brandLinkIdstring
Si aucune valeur n’est définie, l’ID du lien est généré automatiquement par le système.
Sans domaine personnalisé, le domaine par défaut est https://vvd.im.
Exemple : https://vvd.im/[brandLinkId]
ttlstring
Titre du lien. Si aucune valeur n’est précisée, le titre de la page web de l’URL d’origine sera utilisé.
Pour une création plus rapide, définissez directement cette valeur afin d’éviter un traitement inutile.
descriptionstring
Lorsque redirectType est 200, la meta-balise description peut être définie.
metaImgstring
Lorsque redirectType est 200, la meta-balise image peut être définie.
L’URL de l’image doit commencer par https://.
memostring
Note pour la gestion du lien.
notfSubscYnstring
Default:N
Enum:
YN
Indique s’il s’agit d’un lien d’abonnement push.
Si Y, une page de destination s’ouvre avant la redirection pour demander l’autorisation de notification.
Si l’utilisateur refuse ou annule, il est immédiatement redirigé vers l’URL d’origine.
pushNotifyYnstring
Default:N
Enum:
YN
Notifications push pour les clics.
Si Y, des alertes sont envoyées aux appareils avec l’application Vivoldi lorsqu’un seuil de clics défini est atteint (Tableau de bord → Paramètres).
Cette fonctionnalité est disponible à partir du forfait Personnel.
mailNotifyYnstring
Default:N
Enum:
YN
Notifications par e-mail pour les clics.
Si Y, un e-mail est envoyé chaque fois que le seuil de clics défini est atteint (Tableau de bord → Paramètres).
Cette fonctionnalité est disponible à partir du forfait Personnel.
delYmdtdatetime
Date prévue de suppression du lien.
Après cette date, le lien est automatiquement supprimé.
Exemple : 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
Code de réponse : 0 = Succès, autres valeurs = Erreur
messagestring
Message de réponse. Si le code n’est pas 0, un message d’erreur est renvoyé.
resultarray
Données de réponse. Le nombre demandé d’URL raccourcies est renvoyé sous forme de tableau.