Massenlink-Erstellung

API zum gleichzeitigen Erstellen mehrerer Kurzlinks.
Für Massenerstellung können Sie auch das Menü [Massenlinks erstellen] im Dashboard nutzen.

Die maximale Anzahl an Links, die je nach Tarif gleichzeitig erstellt werden können:

  • Personal-Tarif: bis zu 100
  • Premium-Tarif: bis zu 200
  • Business-Tarif: bis zu 300

Wenn Sie mehr Links benötigen, rufen Sie diese API mehrfach auf.
Diese API ist ab dem Personal-Tarif verfügbar.

POST

/api/link/v1/createBulk 

{
    "links": [
        {
            "url": "https://google.com",
            "domain": "https://vvd.bz"
        },
        {
            "url": "https://facebook.com",
            "domain": "https://vvd.bz"
        },
        {
            "url": "https://twitter.com",
            "domain": "https://vvd.bz"
        }
    ]
}

Request Parameters

linksarrayrequired
Ein Array mit mehreren Links. Jedes Element hat die gleiche Struktur wie die Create API.
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.
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": [
        {
            "shortUrl": "https://vvd.bz/bbuR",
            "url": "https://google.com"
        },
        {
            "shortUrl": "https://vvd.bz/bbuS",
            "url": "https://facebook.com"
        },
        {
            "shortUrl": "https://vvd.bz/bbuT",
            "url": "https://twitter.com"
        }
    ]
}

Response Parameters

codeinteger
Antwortcode: 0 = Erfolg, andere Werte = Fehler
messagestring
Antwortnachricht. Wenn der Code nicht 0 ist, wird eine Fehlermeldung zurückgegeben.
resultarray
Antwortdaten. Die angeforderte Anzahl von Kurz-URLs wird als Array zurückgegeben.