API zur Linklöschung

Kurzlinks dauerhaft löschen.

Gelöschte Links können nicht wiederhergestellt werden und sind sofort nicht mehr erreichbar.
Stellen Sie sicher, dass der Link nicht mehr verwendet wird, bevor Sie ihn löschen.

Für wichtige Links empfehlen sich Branding-Links (benutzerdefinierte IDs), die bei Bedarf neu erstellt werden können.

Nutzen Sie diese API, um nicht benötigte Links zu entfernen oder den Zugriff zu sperren.

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
Link-ID.
Wenn die URL „https://vvd.bz/fML“ lautet, ist die Link-ID fML.
domain string required
Default:https://vvd.bz
Link-Domain. 
{
    "code": 0,
    "message": "",
    "result": null
}

Response Parameters

code integer
Antwortcode: 0 = Erfolg, andere Werte = Fehler
message string
Antwortnachricht. Wenn der Code nicht 0 ist, wird eine Fehlermeldung zurückgegeben.
result null

Wann diese API verwenden

Verwenden Sie diese API in folgenden Fällen:

  • Links aus abgeschlossenen Kampagnen oder Events bereinigen
  • Fehlerhaft erstellte Links entfernen
  • Links aus Sicherheitsgründen sofort deaktivieren
  • Ihr Konto durch Entfernen ungenutzter Links übersichtlich halten
Gelöschte Links werden sofort deaktiviert und funktionieren auch über bereits geteilte URLs nicht mehr.
Wenn Sie nur das Ziel ändern möchten, verwenden Sie die Link-Update-API (Update API).

Unterschiede zur Update-API

Die Lösch-API entfernt einen Link vollständig, die Update-API ändert ihn nur.

  • Löschen: Der Kurzlink wird dauerhaft entfernt. Beim Aufruf erscheint eine Fehlerseite, eine Wiederherstellung ist nicht möglich.
  • Aktualisieren: Der Link bleibt aktiv, nur Ziel oder Einstellungen werden geändert. Bereits geteilte Links funktionieren weiterhin.

Auswirkungen der Löschung

Das Löschen eines Links hat folgende Auswirkungen:

  • Die Kurz-URL wird sofort deaktiviert
  • Beim Aufruf erscheint eine Fehlermeldung oder keine Seite
  • Der Zugriff auf zugehörige Statistiken kann eingeschränkt sein
  • Alle bereits geteilten Links werden ungültig
Die Löschung ist endgültig und sollte mit Vorsicht durchgeführt werden.

Wichtige Hinweise

Die Löschung ist endgültig – bitte prüfen Sie folgende Punkte.

  • Stellen Sie sicher, dass linkId und domain korrekt sind
  • Gelöschte Links können nicht wiederhergestellt werden
  • Für wichtige Links empfiehlt sich brandLinkId, um IDs bei Bedarf neu zu erstellen
  • Prüfen Sie den Einflussbereich vor Massenlöschungen sorgfältig
In Produktionsumgebungen sollten Löschrechte eingeschränkt werden.