API de suppression de liens

Supprimez un lien court de manière permanente.

Une fois supprimé, le lien ne peut pas être restauré et l’accès est immédiatement bloqué.
Assurez-vous qu’il n’est plus utilisé avant de le supprimer.

Pour les liens importants, privilégiez des liens personnalisés (ID défini) pouvant être recréés si nécessaire.

Utilisez cette API pour supprimer les liens inutiles ou restreindre l’accès.

DELETE

/api/link/v1/delete?linkId={linkId}&domain={domain} 


DELETE /api/link/v1/delete
        ?linkId=4Rt3
        &domain=https%3A%2F%2Fvvd.bz

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. 
{
    "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

Quand utiliser cette API

Utilisez cette API dans les cas suivants :

  • Nettoyer les liens issus d’événements ou campagnes terminés
  • Supprimer des liens créés par erreur
  • Désactiver immédiatement des liens pour des raisons de sécurité
  • Garder votre compte organisé en supprimant les liens inutiles
Les liens supprimés sont désactivés instantanément et ne fonctionnent plus, même s’ils ont été partagés.
Si vous souhaitez uniquement modifier la destination, utilisez plutôt l’API de mise à jour (Update API).

Différences avec l’API de mise à jour

L’API de suppression supprime entièrement le lien, tandis que l’API de mise à jour le modifie.

  • Suppression : Le lien est définitivement supprimé. Son accès affiche une page d’erreur et il ne peut pas être restauré.
  • Mise à jour : Le lien reste actif, seule l’URL cible ou les paramètres changent. Les liens déjà partagés continuent de fonctionner.

Impact de la suppression

La suppression d’un lien entraîne les effets suivants :

  • Le lien court est immédiatement désactivé
  • L’accès affiche une erreur ou aucune page
  • L’accès aux données statistiques associées peut être limité
  • Tous les liens déjà partagés deviennent invalides
La suppression est irréversible, à utiliser avec précaution.

Points à considérer

La suppression est définitive—vérifiez ces points avant de continuer.

  • Assurez-vous que linkId et domain sont corrects
  • Les liens supprimés ne peuvent pas être restaurés
  • Pour les liens critiques, utilisez brandLinkId pour recréer des IDs si nécessaire
  • Évaluez l’impact avant toute suppression en masse
En production, limitez les permissions de suppression pour éviter toute erreur.