Modifier le lien

API permettant de modifier les informations d’une URL courte générée.

Autorisé uniquement lorsque le type de lien est URL. Les autres types (Lien de Publication, Lien Formulaire, Lien Bouton, etc.) ne seront pas mis à jour même si l’API est appelée.

PUT

/api/link/v2/update 

{
    "linkId": "4Rt3",
    "domain": "https://vvd.bz",
    "ttl": "new title",
    "memo": "new my memo"
}

Request Parameters

linkIdstringrequired
ID du lien.
Si l’URL est « https://vvd.bz/fML », l’ID du lien est fML.
domainstringrequired
Default:https://vvd.bz
Domaine du lien.
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.
urlstring
URL d’origine. Jusqu’à 3 000 octets sont autorisés.
Cette fonctionnalité est disponible à partir du forfait Premium.
ttlstring
Titre du lien.
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 de 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 vers l’URL d’origine pour demander l’autorisation des notifications push.
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 notifications sont envoyées aux appareils avec l’application Vivoldi lorsqu’un nombre 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.
webhookEnableYnstring
Default:N
Enum:
YN
Activation du Webhook.
Le Webhook global doit être activé.
Cette fonctionnalité est disponible uniquement dans l’offre Enterprise.
webhookMetricstring
Default:C
Enum:
CP
Critère de réception du Webhook.
C: Basé sur le nombre de clics, P: Basé sur le nombre d’utilisateurs uniques (clics uniques).
webhookFrequencyinteger
Default:1
Enum:
1501002003005001000
Fréquence de réception du Webhook.
1: À chaque clic, 50: Tous les 50 clics, 100: Tous les 100 clics, 300: Tous les 300 clics, 500: Tous les 500 clics, 1000: Tous les 1.000 clics.
delYmdtdatetime
Date planifiée de suppression du lien.
Après cette date, le lien est automatiquement supprimé.
Exemple : 2025-08-30 23:59:59 
{
    "code": 0,
    "message": "",
    "result": null
}

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é.
resultnull