Nutzung
Zur Nutzung der Swagger UI muss diese im Browser aufgerufen werden. Die URL hierfür lautet https://{{IHRESERVERADDRESSE}}/mapedit-core/swagger-ui/
.
Anmeldung
Die erste Funktion, die ausgeführt werden sollte, ist die Login-Funktion des AuthenticationServices unter /rest/authentication/login
.
Nachdem die Funktion ausgeklappt wurde kann der Button Try it out geklickt werden. Anschließend kann der Text in der schwarzen Box editiert und angepasst werden.
Als applicationType
kann mapedit-mobile
eingesetzt werden. Benutzername und Passwort werden im jeweiligen Feld eingesetzt.
Bestätigen Sie Ihre Eingaben mit dem blauen Execute-Button.
Sofern Ihre Eingaben korrekt waren, erhalten Sie ein Stück weiter unten die Antworten des Servers, beginnend mit dem Code 200. 200 steht im HTTP-Kontext für OK, demnach ist alles gut gegangen. Rechts vom Statuscode erhalten wir die Antwort, hierbei ist für uns besonders die Zeile mit "sessionId"
von Interesse. Kopieren Sie den nachfolgenden Wert ohne die Anführungszeichen. Scrollen Sie nun wieder zum Beginn der Website und klicken Sie auf den Authorize-Button.
Fügen Sie nun Ihre Session-ID in die Textbox ein.
und bestätigen Sie Ihre Eingabe.
Anschließend können Sie alle Funktionen der Swagger UI nutzen.