Developer API

Modifier le lien

Cette API permet de modifier les informations d’une URL raccourcie existante.
Les modifications ne sont autorisées que si le type de lien est URL.
Pour les autres types (liens de publication, formulaires, boutons ou cartes), les requêtes de modification seront ignorées et aucun changement ne sera appliqué.

Http Header

PUT /api/link/v2/update
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: application/json
User-agent: {Your User-agent}
Accept-Language: en

Request

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

Domaines	Description des champs	Description	Type
linkId	ID de lien	ID du lien court généré. Exemple : Si l’adresse du lien court est "https://vvd.bz/fML", l’ID de lien est fML.	string
domain	Domaine	Le domaine de l’adresse du lien court. Exemple : Si l’adresse du lien court est "https://vvd.bz/fML", le domaine est https://vvd.bz. Important : Vous devez saisir https:// ou http://. Si vous indiquez un domaine différent de celui du lien généré, une erreur se produira.	string
redirectType	Type de redirection	Définit la méthode de redirection du lien court vers l’URL longue. Valeurs possibles : 200, 301 ou 302 (HTTP). Par défaut : 302. Pour plus d’informations, voir la page “Glossaire”.	int
grpIdx	ID de groupe	Permet de changer le groupe du lien généré. Pour obtenir l’ID de groupe, vous devez utiliser l’API "Liste des groupes".	int
url	URL longue	Permet de modifier l’URL longue. La modification de l’URL longue est disponible à partir de l’offre Premium.	string
ttl	Titre du lien	Si la valeur est vide, le titre du lien ne sera pas modifié.	string
description	Méta description	Vous pouvez définir la balise meta description de la page si “redirectType” vaut “200”. Ce champ est ignoré si “redirectType” est “301”, “302”, etc.	string
metaImg	Méta-image	Vous ne pouvez définir la balise méta-image que lorsque la valeur de redirectType est « 200 ». La valeur méta-image doit être au format URL commençant par « https:// ». Si redirectType est « 301 » ou « 302 », la valeur est ignorée.	string
memo	Notes	Vous pouvez ajouter des informations administratives supplémentaires, qui ne seront pas visibles par les utilisateurs. Si le champ est vide, la note ne sera pas modifiée.	string
notfSubscYn	Lien Push	Si la valeur est Y, cliquer sur le lien généré affichera une notification push avant de diriger vers l’URL longue. Si l’utilisateur a accepté les notifications push, vous pouvez envoyer un message push à tous les utilisateurs autorisés. Si l’utilisateur refuse ou ferme la notification, il sera immédiatement redirigé vers l’URL longue. Si vous ne renseignez pas de valeur, la valeur par défaut sera N. Pour en savoir plus sur les liens d’abonnement push, cliquez ici.	Y ou N
pushNotifyYn	Notifications push	Si la valeur est Y, vous recevrez des notifications push sur vos appareils mobiles avec l’application Vivoldi installée chaque fois qu’un lien atteint le nombre de clics défini dans les paramètres du lien dans "Paramètres -> Préférences". Cette fonctionnalité est disponible à partir de l’offre Personnel.	Y ou N
mailNotifyYn	Notifications e-mail	Si la valeur est Y, vous recevrez un e-mail à votre adresse Vivoldi à chaque fois que le nombre de clics défini dans les paramètres du lien dans "Paramètres -> Préférences" est atteint. Cette fonctionnalité est disponible à partir de l’offre Personnel.	Y ou N
delYmd	Date de suppression du lien	Après la date indiquée, le lien est automatiquement supprimé par le système. Cycle de suppression : toutes les heures. Exemple : 2025-12-31	Date

Response

{
	"code": 0,
	"message": "",
	"result": null
}

Domaines	Description	Type
code	Code de réponse (0:Succès)	int
message	Le message de réponse, ou un message connexe si le code de réponse est différent de zéro.	string