user-controller Endpoints

Endpoints of the Web-API gateway for user settings management, accessible for any authenticated user.

>> API-WEB Service

The endpoints are used by the CLIENT Service that provides yuuvis® client as reference implementation. They internally call the USERSERVICE.

HTTP Method
as of product version
PurposeResponse FormatDescription
GET
as of 2020 Autumn,
deprecateted as of 2023 Spring
getUserInfoJSON

Retrieves user-specific data for the user specified by userId.
/api-web/api/users/{userId}

GET
as of 2020 Autumn
getResultListConfigurationJSON

Returns a result list configuration by type.
/api-web/api/users/config/result/{type}

POST
as of 2020 Autumn
saveResultListConfigurationHTTP status code

Saves a result list configuration for the user by type.
/api-web/api/users/config/result/{type}

GET
as of 2020 Autumn,
deprecateted as of 2021 Winter

getGlobalSettingsJSON

This request retrieves the global settings with the section name.
/api-web/api/users/globalsettings/{section}

POST
as of 2020 Autumn,
deprecateted as of 2021 Winter
saveGlobalSettingsHTTP status code

Saves a global settings by a section.
/api-web/api/users/globalsettings/{section}

GET
as of 2020 Autumn
getGeneralSettingsJSON

This request retrieves the general settings of the requested user.
/api-web/api/users/settings

POST
as of 2020 Autumn
saveGeneralSettingsHTTP status code

Saves a general settings for the user.
/api-web/api/users/settings

GET
as of 2020 Autumn
getSettingsJSON

This request retrieves the settings of the requested user in user matching the section name.
/api-web/api/users/settings/{section}

POST
as of 2020 Autumn
saveSettingsHTTP status code

Saves a settings for the user by a section.
/api-web/api/users/settings/{section}

GET
as of 2020 Autumn,
deprecateted as of 2023 Spring
getUsersJSON

Retrieves a list of all users. The result list can be filtered by applying conditions that have to be matched.
/api-web/api/users/users

GET
as of 2020 Autumn,
deprecateted as of 2023 Spring
whoAmIJSON

This request retrieves the user information of the current logged in user.
/api-web/api/users/whoami