Unter https://api.srv.nat.tum.de/docs/ steht eine Dokumentation der DSSNAT-API zur Verfügung. Mit dieser Oberfläche (Swagger-UI) können einzelne Endpunkte "von Hand" aufgerufen werden.
Anmeldung an der Swagger-UI
Um sich bei der Swagger-UI-Oberfläche anzumelden, nutzen Sie den Knopf "Authorize"
oben links oder das graue Schloß-Symbol, das bei allen Zugriffsbeschränkten Endpunkten angezeigt wird
.
In dem anschließenden Dialog "Available authorizations" klicken Sie im ersten Abschnitt "OAuth2AuthorizationCodeBearer (OAuth2, authorizationCode with PKCE)" erneut auf "Authorize".
Sie werden dann zum Keycloak-Server (https://sso.srv.nat.tum.de) der TUM School of Natural Sciences weitergeleitet, wo Sie sich mit Ihrer TUM-Kennung ("go42tum") und dem zugehörigen Passwort anmelden können. Anschließend sind Sie für fünf Minuten angemeldet und können zugriffbeschränkte Endpunkte in der Swagger-UI aufrufen.
Sollten Sie beim Aufruf die Fehlermeldung "Signature has expired." erhalten, müssen Sie die Anmeldung wie oben wiederholen – bei Bedarf vorher "Logout".