Link erstellen

Dies ist die Standard-API zum Erstellen von Kurzlinks.

Um mehrere Links gleichzeitig zu erstellen, verwenden Sie die Bulk Create API oder das Menü [Massenlinks erstellen] im Dashboard.

Für jeden Kurzlink wird automatisch ein QR-Code generiert.

  • QR-Codes sind unter https://vvd.bz/[linkId]/qr verfügbar. Die Größe lässt sich über den Parameter size anpassen.
  • Beispiel: https://vvd.bz/hj7V/qr?size=200 → Gibt einen QR-Code mit 200px zurück.
POST

/api/link/v2/create 

{
    "url": "https://www.facebook.com/vivoldi365",
    "domain": "https://vvd.bz"
}

Request Parameters

urlstringrequired
Ursprüngliche URL.
Bis zu 3.000 Bytes sind erlaubt.
domainstringrequired
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.
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.
brandLinkIdstring
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]
ttlstring
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.
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.
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": "https://vvd.bz/jH3d"
}

Response Parameters

codeinteger
Antwortcode: 0 = Erfolg, andere Werte = Fehler
messagestring
Antwortnachricht. Wenn der Code nicht 0 ist, wird eine Fehlermeldung zurückgegeben.
resultstring
Antwortwert. Der Kurzlink wird zurückgegeben.
Beispiel: https://vvd.bz/jH3d