Authentifizierungsanfrage

Um Benutzerinformationen anzuzeigen oder zu ändern, muss zunächst ein Authentifizierungstoken ausgestellt werden.

Das ausgestellte Token ist 1 Minute lang gültig und muss in allen nachfolgenden Anfragen im HTTP-Header als X-Access-Token enthalten sein.

Dieses Token schützt Benutzerkonten und ermöglicht eine sichere Authentifizierung ohne langfristige Sitzungen.

Diese API ist für Personal-Tarife und höher verfügbar.

POST

/api/user/v1/auth

{
    "eml": "your@gmail.com"
}

Request Parameters

emlstring: E-Mail-Adresse.
Wird verwendet, um Informationen von innerhalb der Organisation hinzugefügten Benutzern im Business-Tarif oder höher abzufragen oder zu ändern.
Wird in den Personal- und Premium-Tarifen ignoriert.

{
    "code": 0,
    "message": "",
    "result": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

codeinteger: Antwortcode: 0 = Erfolg, andere Werte = Fehler
messagestring: Antwortnachricht. Wenn der Code nicht 0 ist, wird eine Fehlermeldung zurückgegeben.
resultstring: Beim Abrufen oder Aktualisieren von Benutzerinformationen muss es im HTTP-Header unter X-Access-Token hinzugefügt werden.
Das Token ist 1 Minute lang gültig und muss nach Ablauf (durch erneuten Aufruf dieser API) neu ausgestellt werden.