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
- linkId string required
-
ID du lien.
Si l’URL est « https://vvd.bz/fML », l’ID du lien est fML. - domain string required
- Default:https://vvd.bz
- Domaine du lien.
- redirectType integer
- Default:302
-
Enum:
200301302
-
Type de redirection.
Voir la page Terminologie pour plus de détails.
Cette fonctionnalité est disponible à partir du forfait Personnel. - grpIdx integer
-
Utilisé pour regrouper les liens.
L’IDX de groupe peut être obtenu via l’API Liste de Groupes ou depuis le tableau de bord. - url string
-
URL d’origine. Jusqu’à 3 000 octets sont autorisés.
Cette fonctionnalité est disponible à partir du forfait Premium. - ttl string
- Titre du lien.
- description string
-
Lorsque
redirectTypeest200, la meta-balise description peut être définie. - metaImg string
-
Lorsque
redirectTypeest200, la meta-balise image peut être définie.
L’URL de l’image doit commencer parhttps://. - memo string
- Note de gestion du lien.
- notfSubscYn string
- 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. - qrBypassYn string
- Par défaut :N
-
Enum :
YN
-
Contrôle s’il faut ignorer le lien court lors du scan d’un code QR et accéder directement à l’URL d’origine définie par l’utilisateur.
Y : Redirige directement vers l’URL d’origine sans passer par le lien court. (Les statistiques de scan QR ne sont pas enregistrées)
N : Passe par le lien court avant de rediriger vers l’URL d’origine. (Les statistiques de scan QR sont enregistrées)
- pushNotifyYn string
- 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. - mailNotifyYn string
- 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. - webhookEnableYn string
- Default:N
-
Enum:
YN
-
Activation du Webhook.
Le Webhook global doit être activé.
Cette fonctionnalité est disponible uniquement dans l’offre Enterprise. - webhookMetric string
- 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). - webhookFrequency integer
- 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. - delYmdt datetime
-
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
- code integer
- Code de réponse : 0 = Succès, autres valeurs = Erreur
- message string
- Message de réponse. Si le code n’est pas 0, un message d’erreur est renvoyé.
- result null