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
est200
, la meta-balise description peut être définie. - metaImgstring
- Lorsque
redirectType
est200
, la meta-balise image peut être définie.
L’URL de l’image doit commencer parhttps://
. - memostring
- Note de gestion du lien.
- notfSubscYnstring
- Default:N
- Enum:YN
- Indique s’il s’agit d’un lien d’abonnement push.
SiY
, 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.
SiY
, 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.
SiY
, 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 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