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

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.
redirectType integer
Default:302
Enum:
200301302
Umleitungsart.
Weitere Informationen finden Sie auf der Seite Begriffe.
Diese Funktion ist ab dem Personal-Tarif verfügbar.
grpIdx integer
Wird zur Gruppierung von Links verwendet.
Der Gruppen-IDX kann über die Linkgruppen-API oder im Dashboard eingesehen werden.
url string
Ursprüngliche URL. Bis zu 3.000 Bytes sind erlaubt.
Diese Funktion ist ab dem Premium-Tarif verfügbar.
ttl string
Link-Titel.
description string
Wenn redirectType 200 ist, kann das Description-Meta-Tag gesetzt werden.
metaImg string
Wenn redirectType 200 ist, kann das Image-Meta-Tag gesetzt werden.
Die Bild-URL muss mit https:// beginnen.
memo string
Notiz zur Linkverwaltung.
notfSubscYn string
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.
qrBypassYn string
Standardwert:N
Enum:
YN
Steuert, ob beim Scannen eines QR-Codes die Kurz-URL übersprungen und direkt die vom Benutzer festgelegte Original-URL aufgerufen wird.
Y: Leitet direkt zur Original-URL weiter, ohne die Kurz-URL zu passieren. (QR-Scan-Statistik wird nicht erfasst)
N: Geht über die Kurz-URL, bevor zur Original-URL weitergeleitet wird. (QR-Scan-Statistik wird erfasst)
pushNotifyYn string
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.
mailNotifyYn string
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.
webhookEnableYn string
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.
webhookMetric string
Default:C
Enum:
CP
Empfangskriterium für den Webhook.
C: Nach Klickanzahl, P: Nach Benutzeranzahl (eindeutige Klicks).
webhookFrequency integer
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.
delYmdt datetime
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

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