Entwickler-API

Link erstellen

Diese API erstellt eine Kurz-URL.
Um mehrere Links gleichzeitig zu generieren, verwenden Sie bitte die “Bulk Create”-API.
Alternativ können Sie im Dashboard über das Menü „Massenlink-Erstellung“ schnell Links anlegen.

Für jeden Kurzlink wird automatisch ein QR-Code generiert.
Der QR-Code ist unter folgender URL abrufbar:
vvd.bz/[linkId]/qr

Um die Größe des QR-Codes anzupassen, fügen Sie den Parameter size hinzu.
Beispiel: vvd.bz/[linkId]/qr?size=200 → erzeugt einen QR-Code mit 200 Pixeln

Http Header

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

Request

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

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

Response

{
	"code": 0,
	"message": "",
	"result": "https://vvd.bz/jH3d"
}

Felder	Beschreibung	Typ
code	Antwortcode (0:Erfolg)	int
message	Die Antwortnachricht oder eine zugehörige Nachricht, wenn der Antwortcode ungleich Null ist.	string
result	Antwortwert (verkürzter Link)	string