API zur Linkerstellung

Request Parameters

url string required

Ursprüngliche URL.
Bis zu 3.000 Bytes sind erlaubt.

domain string required

Default:https://vvd.bz

Link-Domain.
Wenn die Option „brandLinkId“ auf Y gesetzt ist, lautet die Domain https://vvd.im.
Es kann auch eine benutzerdefinierte Domain verwendet werden.

redirectType integer

Default:302

Enum:

200301302

Umleitungsart.
Weitere Informationen finden Sie auf der Seite Begriffe.
Diese Funktion ist ab dem Personal-Tarif verfügbar.

reuseYn string

Standard:N

Enum:

YN

Gibt an, ob eine vorhandene URL wiederverwendet wird.
Y: Wenn dieselbe lange URL bereits existiert, wird keine neue Kurz-URL erstellt – die zuerst erzeugte Kurz-URL wird zurückgegeben.
N: Es wird immer eine neue Kurz-URL erstellt.

Diese Option wird verwendet, um doppelte lange URLs zu vermeiden oder vorhandene Links wiederzuverwenden.
Diese Funktion ist nur in Premium-Tarifen und höher verfügbar.

grpIdx integer

Wird zur Gruppierung von Links verwendet.
Der Gruppen-IDX kann über die Linkgruppen-API oder im Dashboard eingesehen werden.

brandLinkId string

Wenn kein Wert angegeben ist, wird die Link-ID automatisch vom System generiert.
Ohne benutzerdefinierte Domain lautet die Standard-Domain https://vvd.im.
Beispiel: https://vvd.im/[brandLinkId]

ttl string

Link-Titel. Wenn kein Wert angegeben ist, wird automatisch der Seitentitel der ursprünglichen URL verwendet.
Um die Erstellung zu beschleunigen, geben Sie diesen Wert direkt an und überspringen Sie unnötiges Parsing.

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