Anmeldung über die API
Wie man sich über die API bei FCC anmeldet
Es gibt mehrere API-Endpunkte, die für die Anmeldung verwendet werden können. Die hier beschriebene Login-API ist /login. Es gibt verschiedene, wie z. B. /auth/forceLogin, der eine Anmeldung erzwingt, indem er eine ältere Sitzung beendet, wenn der Benutzer bereits angemeldet war.
Um die Swagger-API zu verwenden, müssen Sie in der Datei xserver .
properties die Option xserver.swagger.enable=true
einstellen.
Um eine Anfrage zu erstellen, erstellen Sie einen POST-Aufruf an /login, wie https://my-address/login. Der JSON-Körper des Aufrufs sollte wie folgt aussehen:
{
"username":"myuser",
"password":"qwer1234",
"domain":"ubimax",
"agreedToTos":"true"
}
Hier geben wir den Benutzernamen, das Passwort und die Domäne an. Danach können wir die Anfrage ausführen.
Die Antwort, die wir zurückbekommen, wird folgendermaßen aussehen:
{
"token": "eyJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJGQ0MiLCJzdWIiOiJ0ZXN0ZXIiLCJkb21haW4iOiJ1YmltYXgiLCJpZCI6MTYyOTI4NDQ0ODg0OSwiaWF0IjoxNjI5Mjg0NDQ4LCJleHAiOjE2MjkyODQ3NDh9.9qhH0Jpf-xtzPa5Gu3CUt89dVag-8obzV-dNYsGojs_GNdfSfcM_iJ4rA01-Wg7Gr3LQfRkjtLhC95AHLmtc5A",
"refreshToken": "eyJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJGQ0MiLCJzdWIiOiJ0ZXN0ZXIiLCJkb21haW4iOiJ1YmltYXgiLCJpYXQiOjE2MjkyODQ0NDgsImV4cCI6MTYyOTg4OTI0OH0.-L38U0FsXHhOJCxWus4kXEezSm6tcZ3u2nKzhZX9C_0ZqyRrscG7sDNWsP8gUREeNRrXpvA1YAUqamQRQb8_QA",
"permissions": [
"ROLE_adm_administration",
...
]
}
Für die folgenden API-Aufrufe können wir nun das Token, das wir als Bearer Token erhalten haben, als Autorisierung verwenden.
Einen allgemeinen Überblick über die verfügbaren API-Aufrufe erhalten Sie unter https://my-address/admin.html#!/apis.
Hier sind alle API-Aufrufe mit den Daten, die sie zur Ausführung benötigen, aufgelistet und können auch ausprobiert werden. Dies wäre die API-Beschreibung für /login:
Hier sehen wir, dass ein usernamePasswordLoginModel erwartet wird, das unten als Beispiel definiert ist. Wenn wir nun das Feld ausfüllen und die Anfrage ausführen. Das Ergebnis sieht wie folgt aus:
Das Ergebnis zeigt die URL, an die wir die Anfrage geschickt haben, und den curl-Befehl.