Entwickler-API

Massenlink-Erstellung

Mit dieser API können Sie mehrere Kurzlinks gleichzeitig erstellen.
Für die Massenlink-Erstellung nutzen Sie bitte das Menü „Massenlink-Erstellung“ im Dashboard.

Die Anzahl der Links pro Anfrage ist je nach Tarif begrenzt.
Um mehr Links zu erstellen, rufen Sie diese API mehrfach auf.

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

Diese API ist ab dem Personal-Tarif verfügbar.

Http Header

POST /api/link/v1/createBulk
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: application/json
User-agent: {Your User-agent}
Accept-Language: en

Request

{
	"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"
		}
	]
}

Felder

Typ

links

Felder	Feldbeschreibungen	Beschreibung	Typ
url	Lange URL	Die lange URL, zu der weitergeleitet wird, wenn der Kurzlink angeklickt wird. Bis zu 3.000 Byte möglich.	string
domain	Domain	Wenn leer, wird automatisch die Domain vvd.bz verwendet. Der Wert muss mit “https://” angegeben werden. Ist “brandLinkId” auf “Y” gesetzt, nutze “https://vvd.im”. Wenn du deine eigene Domain mit Vivoldi verknüpft hast, kannst du sie hier eintragen. Beispiel: https://vvd.bz	string
redirectType	Weiterleitungstyp	Legt fest, wie von Kurz-URL auf Lang-URL weitergeleitet wird. Wähle 200, 301 oder 302 als HTTP-Statuscode. Standardwert: 302 Mehr Infos zu Weiterleitungsmethoden findest du auf der “Glossar”-Seite.	int
grpIdx	Gruppen-ID	Die Angabe einer Gruppen-ID verknüpft den Link mit dieser Gruppe. Die GroupID erhältst du über die "Gruppenliste"-API.	int
brandLinkId	Brand Link ID	Bei Angabe eines Werts wird der Link mit dieser ID erstellt. (Wenn gesetzt, ist die Domain vvd.im statt vvd.bz.) Bei leerem Wert wird die Link-ID automatisch generiert.	string
ttl	Link-Titel	Wenn leer, wird der Seitentitel der langen URL gespeichert. Bei leerem Wert wird die lange URL aufgerufen und HTML geparst, daher bei langsamer Antwort besser einen Titel angeben.	string
description	Meta-Beschreibung	Du kannst das Meta-Description-Tag der Seite setzen, wenn redirectType auf „200” steht. Bei „301”, „302” usw. wird dieser Wert ignoriert.	string
metaImg	Meta-Bild	Sie können das Meta-Bild-Tag nur festlegen, wenn der Wert von redirectType „200” ist. Der Wert des Meta-Bildes muss im URL-Format beginnen mit „https://”. Wenn redirectType „301” oder „302” ist, wird der Wert ignoriert.	string
memo	Notizen	Du kannst hier interne Informationen für die Verwaltung eintragen. Sie sind für Nutzer nicht sichtbar.	string
notfSubscYn	Push-Link	Bei Wert Y erscheint beim Klick auf den Link zuerst ein Web-Push-Popup, bevor weitergeleitet wird. Push-Nachrichten können an alle Nutzer mit Erlaubnis gesendet werden. Wenn abgelehnt oder geschlossen, wird direkt weitergeleitet. Standardwert (bei leer): N Mehr unter Web Push-Funktionsseite.	Y oder N
pushNotifyYn	Push-Benachrichtigungen	Bei Y erhältst du Push-Nachrichten auf Mobilgeräte mit Vivoldi-App, wenn die Klickzahl (gemäß Einstellungen unter “Einstellungen -> Präferenzen”) erreicht ist. Verfügbar ab Personal-Tarif.	Y oder N
mailNotifyYn	E-Mail-Benachrichtigungen	Bei Y erhältst du Infos zur Klickzahl per E-Mail, wenn die Zielzahl erreicht ist. Verfügbar ab Personal-Tarif.	Y oder N
delYmd	Link-Löschdatum	Nach dem eingestellten Datum wird der Link automatisch entfernt. Löschintervall: stündlich Beispiel: 2025-12-31	Date

array

Response

{
	"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"
		}
	]
}

Felder	Beschreibung	Typ
code	Antwortcode. `0` steht für Erfolg, jeder andere Wert für einen Fehler.	int
message	Antwortnachricht. Wird nur bei `code` ≠ 0 zurückgegeben und beschreibt den Fehler.	string
result	Antwortdaten. Gibt ein Array mit den generierten Kurz-URLs entsprechend der Anforderung zurück.	array