Link bearbeiten

API zum Aktualisieren der Informationen einer erstellten Kurz-URL.

Nur erlaubt, wenn der Linktyp URL ist. Andere Typen (Beitrags-Link, Formular-Link, Button-Link usw.) werden auch bei Aufruf der API nicht übernommen.

PUT

/api/link/v2/update 

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

Request Parameters

linkIdstringrequired
Link-ID.
Wenn die URL „https://vvd.bz/fML“ lautet, ist die Link-ID fML.
domainstringrequired
Default:https://vvd.bz
Link-Domain.
redirectTypeinteger
Default:302
Enum:
200301302
Umleitungsart.
Weitere Informationen finden Sie auf der Seite Begriffe.
Diese Funktion ist ab dem Personal-Tarif verfügbar.
grpIdxinteger
Wird zur Gruppierung von Links verwendet.
Der Gruppen-IDX kann über die Linkgruppen-API oder im Dashboard eingesehen werden.
urlstring
Ursprüngliche URL. Bis zu 3.000 Bytes sind erlaubt.
Diese Funktion ist ab dem Premium-Tarif verfügbar.
ttlstring
Link-Titel.
descriptionstring
Wenn redirectType200 ist, kann das Description-Meta-Tag gesetzt werden.
metaImgstring
Wenn redirectType200 ist, kann das Image-Meta-Tag gesetzt werden.
Die Bild-URL muss mit https:// beginnen.
memostring
Notiz zur Linkverwaltung.
notfSubscYnstring
Default:N
Enum:
YN
Gibt an, ob es sich um einen Push-Abonnement-Link handelt.
Wenn Y, wird vor der Weiterleitung zur Original-URL eine Landingpage angezeigt, die den Benutzer um Berechtigung für Push-Benachrichtigungen bittet.
Wenn der Benutzer ablehnt oder abbricht, erfolgt sofort die Weiterleitung zur Original-URL.
pushNotifyYnstring
Default:N
Enum:
YN
Push-Benachrichtigungen für Klicks.
Wenn Y, werden Benachrichtigungen an Geräte mit der Vivoldi-App gesendet, sobald die im Dashboard → Einstellungen festgelegte Klickanzahl erreicht ist.
Diese Funktion ist ab dem Personal-Tarif verfügbar.
mailNotifyYnstring
Default:N
Enum:
YN
E-Mail-Benachrichtigungen für Klicks.
Wenn Y, wird bei Erreichen der festgelegten Klickanzahl eine E-Mail versendet (eingestellt im Dashboard → Einstellungen).
Diese Funktion ist ab dem Personal-Tarif verfügbar.
webhookEnableYnstring
Default:N
Enum:
YN
Einstellung für die Webhook-Nutzung.
Der globale Webhook muss aktiviert sein.
Diese Funktion ist nur im Enterprise-Tarif verfügbar.
webhookMetricstring
Default:C
Enum:
CP
Empfangskriterium für den Webhook.
C: Nach Klickanzahl, P: Nach Benutzeranzahl (eindeutige Klicks).
webhookFrequencyinteger
Default:1
Enum:
1501002003005001000
Empfangsfrequenz des Webhooks.
1: Bei jedem Klick, 50: Alle 50 Klicks, 100: Alle 100 Klicks, 300: Alle 300 Klicks, 500: Alle 500 Klicks, 1000: Alle 1.000 Klicks.
delYmdtdatetime
Geplanter Löschtermin des Links.
Nach diesem Datum wird der Link automatisch gelöscht.
Beispiel: 2025-08-30 23:59:59 
{
    "code": 0,
    "message": "",
    "result": null
}

Response Parameters

codeinteger
Antwortcode: 0 = Erfolg, andere Werte = Fehler
messagestring
Antwortnachricht. Wenn der Code nicht 0 ist, wird eine Fehlermeldung zurückgegeben.
resultnull