Installieren Sie die Vivoldi-App von Google Play, um es noch bequemer zu machen.

API zur Aktualisierung von Benutzerkonten

Aktualisieren Sie Benutzerkontoinformationen mithilfe eines Zugriffstokens.

Halten Sie Kontodaten aktuell und erhöhen Sie die Sicherheit, indem Sie E-Mail-Adresse und Passwort aktualisieren.

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

PUT

/api/user/v1/update

HTTP Header 
X-Access-Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
{
    "eml": "yourchange@gmail.com",
    "pwd": "Zght943!"
}

Request Parameters

eml string
Neue E-Mail-Adresse, die geändert werden soll.
Nach dem Ändern der E-Mail-Adresse ist beim nächsten Login eine erneute Authentifizierung erforderlich.
pwd string
Neues Passwort, das geändert werden soll.
Muss 6–30 Zeichen lang sein und eine Kombination aus Buchstaben und Zahlen enthalten. 
{
    "code": 0,
    "message": "",
    "result": null
}

Response Parameters

code integer
Antwortcode: 0 = Erfolg, andere Werte = Fehler
message string
Antwortnachricht. Wenn der Code nicht 0 ist, wird eine Fehlermeldung zurückgegeben.
result null

Wann diese API verwenden

Verwenden Sie diese API, wenn ein Benutzer seine verknüpfte E-Mail-Adresse aktualisieren oder aus Sicherheitsgründen sein Passwort zurücksetzen muss.

Sie ist besonders wichtig für die Durchsetzung regelmäßiger Passwortänderungsrichtlinien in Unternehmensumgebungen sowie für die Automatisierung von Workflows zur Synchronisierung von Benutzerdaten.

Hinweise beim Ändern der E-Mail

Das Ändern der E-Mail-Adresse ist keine einfache Aktualisierung.
Nach der Änderung ist eine erneute Anmeldung mit der neuen E-Mail erforderlich, und ein neues Zugriffstoken muss ausgestellt werden.

Bei automatisierten Prozessen kann das Aufrufen weiterer APIs mit dem alten Token direkt nach der Änderung zu Authentifizierungsfehlern führen.

Rufen Sie nach der E-Mail-Änderung unbedingt erneut die Authentifizierungs-API auf, um ein neues Token zu erhalten, bevor Sie fortfahren.

Passwortrichtlinie

pwd muss 6–30 Zeichen lang sein und eine Kombination aus Buchstaben und Zahlen enthalten. Anfragen, die diese Anforderungen nicht erfüllen, werden abgelehnt.

In automatisierten Umgebungen sollten Passwörter sicher verwaltet und niemals im Klartext gespeichert werden.

Wichtige Punkte im Betrieb

Diese API ist nicht nur eine Datenänderung, sondern eine kritische API, die den Sicherheitsstatus eines Kontos verändert.

Änderungen an E-Mail oder Passwort wirken sich direkt auf Anmeldedaten und Authentifizierungsabläufe aus und können Folgeaktionen wie Sitzungsinvalidierung, erneute Authentifizierung oder Sicherheitsbenachrichtigungen erfordern.

Wichtige Hinweise

Die Änderung der E-Mail-Adresse steht in direktem Zusammenhang mit der Kontoinhaberschaft und sollte daher mit Vorsicht erfolgen.

  • Passwörter dürfen nur über sichere Verbindungen (HTTPS) übertragen werden.
  • Das direkte Aufrufen dieser API vom Client kann Sicherheitsrisiken verursachen.
  • Es wird empfohlen, Tokens unmittelbar nach der Änderung zu invalidieren.
  • Die Eingabevalidierung muss stets serverseitig erfolgen.