Link bearbeiten
Diese API dient zum Aktualisieren der Informationen einer bereits erstellten Kurz-URL.
Änderungen sind nur möglich, wenn der Linktyp URL ist.
Bei anderen Typen (wie Beitragslinks, Formularlinks, Schaltflächenlinks oder Kartenlinks) werden Änderungsanfragen ignoriert und nicht übernommen.
Http Header
PUT /api/link/v2/update
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: application/json
User-agent: {Your User-agent}
Accept-Language: en
Request
{
"linkId": "4Rt3",
"domain": "https://vvd.bz",
"ttl": "new title",
"memo": "new my memo"
}| Felder | Feldbeschreibungen | Beschreibung | Erforderlich | Typ |
|---|---|---|---|---|
| linkId | Link-ID | ID des erzeugten Kurzlinks. Beispiel: Ist die Kurzlink-Adresse "https://vvd.bz/fML", lautet die Link-ID fML. | string | |
| domain | Domain | Die Domain der Kurzlink-Adresse. Beispiel: Ist die Kurzlink-Adresse "https://vvd.bz/fML", ist die Domain https://vvd.bz. Wichtig: Es muss https:// oder http:// eingegeben werden. Wird eine andere Domain als die des erzeugten Links angegeben, tritt ein Fehler auf. | string | |
| redirectType | Weiterleitungstyp | Bestimmt, wie von der Kurz- zur Lang-URL weitergeleitet wird. HTTP-Statuscode: 200, 301 oder 302 möglich. Standardwert: 302. Mehr Informationen findest du auf der Glossar-Seite. | int | |
| grpIdx | Gruppen-ID | Ändert die Gruppe des erzeugten Links. Um die Gruppen-ID zu erfahren, nutze die API "Gruppenliste". | int | |
| url | Lange URL | Ändert die lange URL. Das Ändern der langen URL ist ab dem Premium-Tarif möglich. | string | |
| ttl | Linktitel | Wenn leer, wird der Linktitel nicht geändert. | string | |
| description | Meta-Beschreibung | Meta-Tag Beschreibung der Seite, wenn “redirectType” auf “200” steht. Wird bei “301”, “302” usw. 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 | Zusätzliche administrative Informationen, die nicht für Nutzer sichtbar sind. Wenn leer, wird die Notiz nicht geändert. | string | |
| notfSubscYn | Push-Link | Bei Y erscheint beim Klick ein Web-Push-Popup, bevor zur langen URL weitergeleitet wird. Falls Nutzer Push zugelassen haben, kannst du Push-Nachrichten an alle senden. Wenn abgelehnt/geschlossen, sofort zur langen URL. Ohne Wert ist N Standard. Mehr zu Push-Links: hier klicken. | Y oder N | |
| pushNotifyYn | Push-Benachrichtigungen | Bei Y erhältst du Push-Benachrichtigungen aufs Handy mit installierter Vivoldi-App, wenn die Klickzahl gemäß "Einstellungen -> Präferenzen" erreicht ist. Funktion ab Personal-Tarif. | Y oder N | |
| mailNotifyYn | E-Mail-Benachrichtigungen | Bei Y erhältst du bei Erreichen des Klickziels gemäß "Einstellungen -> Präferenzen" eine E-Mail-Benachrichtigung. Funktion ab Personal-Tarif. | Y oder N | |
| delYmd | Link-Löschdatum | Nach dem eingestellten Datum wird der Link automatisch gelöscht. Löschzyklus: stündlich. Beispiel: 2025-12-31 | Date |
Response
{
"code": 0,
"message": "",
"result": null
}
| Felder | Beschreibung | Typ |
|---|---|---|
| code | Antwortcode (0:Erfolg) | int |
| message | Die Antwortnachricht oder eine zugehörige Nachricht, wenn der Antwortcode ungleich Null ist. | string |