Skip to main content

ManagementApi

All URIs are relative to http://localhost

MethodHTTP requestDescription
deleteSettingDELETE /admin/management/settingDeletes one setting that match the key
getClusterStatusGET /admin/management/cluster/statusGets cluster status
getDefaultPropertiesGET /admin/management/default-propertiesGets default properties of biometric operations
getManagementInfoGET /admin/management/infoGets information and vital parameters of management
getMeGET /admin/management/meGets information about the authorization from the session cookie
getSettingGET /admin/management/settingGets one setting that match the key
getSettingsGET /admin/management/settingsGets all settings saved in management
getSettingsByKeyGET /admin/management/settings/keyGets all settings that starts with the prefix
loginPOST /login
logoutPOST /logout
oauth2TokenPOST /oauth2/tokenToken endpoint
resetSettingsPOST /admin/management/settings/resetResets all default settings.
setSettingPOST /admin/management/settingsSaves or deletes the setting with specified key
truncateDatabaseDELETE /admin/management/database/clear-dbClears all database, except for flyaway schema version and settings

deleteSetting​

deleteSetting(key)

Deletes one setting that match the key

Parameters​

NameTypeDescriptionNotes
keyStringKey for setting to be deleted.[default to null]

Return type​

null (empty response body)

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: /

getClusterStatus​

DbClusterStatus getClusterStatus()

Gets cluster status

Parameters​

This endpoint does not need any parameter.

Return type​

DbClusterStatus

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json, /

getDefaultProperties​

List getDefaultProperties()

Gets default properties of biometric operations

Parameters​

This endpoint does not need any parameter.

Return type​

List

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json, /

getManagementInfo​

Map getManagementInfo()

Gets information and vital parameters of management

Parameters​

This endpoint does not need any parameter.

Return type​

Map

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json, /

getMe​

MeResponse getMe()

Gets information about the authorization from the session cookie

Parameters​

This endpoint does not need any parameter.

Return type​

MeResponse

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json, /

getSetting​

String getSetting(key)

Gets one setting that match the key

Parameters​

NameTypeDescriptionNotes
keyStringPrefix for setting to be fetched.[default to null]

Return type​

String

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json, /

getSettings​

Map getSettings()

Gets all settings saved in management

Parameters​

This endpoint does not need any parameter.

Return type​

Map

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json, /

getSettingsByKey​

Map getSettingsByKey(key)

Gets all settings that starts with the prefix

Parameters​

NameTypeDescriptionNotes
keyStringPrefix for settings to be fetched.[default to null]

Return type​

Map

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: application/json, /

login​

LoginResponse login(password, username)

Authenticates a user using username and password. Returns auth type and granted authorities.

Parameters​

NameTypeDescriptionNotes
passwordString[default to null]
usernameString[default to null]

Return type​

LoginResponse

Authorization​

No authorization required

HTTP request headers​

  • Content-Type: application/x-www-form-urlencoded
  • Accept: application/json, /

logout​

logout()

Logs out the current user and invalidates the session. Clears authentication cookies.

Parameters​

This endpoint does not need any parameter.

Return type​

null (empty response body)

Authorization​

No authorization required

HTTP request headers​

  • Content-Type: Not defined
  • Accept: /

oauth2Token​

AccessTokenResponse oauth2Token(client_id, client_secret, code, code_verifier, grant_type, redirect_uri, scope)

Token endpoint

Token endpoint for both client_credentials and authorization_code (PKCE) flows.

Parameters​

NameTypeDescriptionNotes
client_idStringClient ID[optional] [default to null]
client_secretStringClient Secret (only for client_credentials)[optional] [default to null]
codeStringAuthorization code (only for authorization_code flow)[optional] [default to null]
code_verifierStringPKCE code verifier (authorization_code flow)[optional] [default to null]
grant_typeStringOAuth2 grant type[optional] [default to client_credentials]
redirect_uriStringRedirect URI (authorization_code flow)[optional] [default to null]
scopeStringRequested scope (only for client_credentials)[optional] [default to null]

Return type​

AccessTokenResponse

Authorization​

No authorization required

HTTP request headers​

  • Content-Type: application/x-www-form-urlencoded
  • Accept: application/json, /

resetSettings​

resetSettings()

Resets all default settings.

Parameters​

This endpoint does not need any parameter.

Return type​

null (empty response body)

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: /

setSetting​

setSetting(key, value)

Saves or deletes the setting with specified key

Creates a new setting if the current key do not exists in the database. If the key already exists in the database its value will be updated. If the key exists in the database and the new value is null, the key will be deleted.

Parameters​

NameTypeDescriptionNotes
keyStringSetting's key to be saved.[default to null]
valueStringSetting's value to be saved.[optional] [default to null]

Return type​

null (empty response body)

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: /

truncateDatabase​

truncateDatabase()

Clears all database, except for flyaway schema version and settings

Parameters​

This endpoint does not need any parameter.

Return type​

null (empty response body)

Authorization​

admin-basic, admin-oauth

HTTP request headers​

  • Content-Type: Not defined
  • Accept: /