Security Service

Get access token - to be used as Bearer token header for all other API requests.

POSThttps://localhost:16001/api/v1/oauth2

Query parameters

Body

application/json

User id and password

one of

WebTokenRequest (object)MFAChallengeResponse (object)

Response

200403404

successful operation

Body

application/json

one of

WebTokenResult (object)MFAChallengeRequest (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/oauth2', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "userId": "[e-mail]",
      "password": "support"
    }),
});
const data = await response.json();

Response

200403404

{
  "access_token": "text",
  "refresh_token": "text",
  "token_type": "text",
  "username": "text",
  "userMustChangePassword": false,
  "aclTemplate": {
    "aclTemplate": {
      "Read": false,
      "ReadWrite": false,
      "ReadWriteCreate": false,
      "Delete": false,
      "PortalLogin": false
    }
  }
}

Revoke a token.

DELETEhttps://localhost:16001/api/v1/oauth2/{token}

Path parameters

token*string

Response

204403404

successful operation

Body

application/json

Success (any)

The requested operation was performed.

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/oauth2/{token}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Retrieve the system layout.

GEThttps://localhost:16001/api/v1/systemEndpoints

Response

200403404

successful operation

Body

application/json

endpointsarray of SystemEndpoint (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/systemEndpoints', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "endpoints": [
    {
      "type": "text",
      "vendor": "text",
      "uri": "https://example.com",
      "authenticationType": "text"
    }
  ]
}

Retrieve a list of existing users as well as some information about them.

GEThttps://localhost:16001/api/v1/users

Query parameters

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/users', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Retrieve the information for a single user.

GEThttps://localhost:16001/api/v1/user/{id}

Path parameters

id*string (uuid)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/user/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Create a single user.

POSThttps://localhost:16001/api/v1/user/{id}

Path parameters

id*integer (int64)

Query parameters

Body

application/json

User details (some fields are ignored during creation)

idstring (uuid)

namestring

descriptionstring

avatarstring (uri)

emailstring (email)

validatedboolean

validationEmailstring (email)

validationDateinteger (int64)

createdinteger (int64)

validationURIstring

changePasswordboolean

lastLogininteger (int64)

currentLoginURIstring

lastPasswordChangeinteger (int64)

lastEmailCheckinteger (int64)

currentPasswordstring

lastPasswordsarray of string

waitingForEmailCheckboolean

notesarray of NoteInfo (object)

locationstring (uuid)

ownerstring (uuid)

suspendedboolean

blackListedboolean

localestring

userRoleenum

rootadminsubscribercsrsysteminstallernocaccounting

oauthTypeenum

internalnormalgmailfacebooklinkedininstagram

oauthUserInfostring

securityPolicystring

securityPolicyChangeinteger (int64)

userTypeProprietaryInfoUserLoginLoginExtensions (object)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/user/{id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Modify a single user.

PUThttps://localhost:16001/api/v1/user/{id}

Path parameters

id*integer (int64)

Query parameters

Body

application/json

User details (some fields are ignored during update)

idstring (uuid)

namestring

descriptionstring

avatarstring (uri)

emailstring (email)

validatedboolean

validationEmailstring (email)

validationDateinteger (int64)

createdinteger (int64)

validationURIstring

changePasswordboolean

lastLogininteger (int64)

currentLoginURIstring

lastPasswordChangeinteger (int64)

lastEmailCheckinteger (int64)

currentPasswordstring

lastPasswordsarray of string

waitingForEmailCheckboolean

notesarray of NoteInfo (object)

locationstring (uuid)

ownerstring (uuid)

suspendedboolean

blackListedboolean

localestring

userRoleenum

rootadminsubscribercsrsysteminstallernocaccounting

oauthTypeenum

internalnormalgmailfacebooklinkedininstagram

oauthUserInfostring

securityPolicystring

securityPolicyChangeinteger (int64)

userTypeProprietaryInfoUserLoginLoginExtensions (object)

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/user/{id}', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Delete a single user.

DELETEhttps://localhost:16001/api/v1/user/{id}

Path parameters

id*integer (int64)

Response

204403404

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/user/{id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

204403404

{
  "Operation": "text",
  "Details": "text"
}

Retrieve the avatar associated with a user ID.

GEThttps://localhost:16001/api/v1/avatar/{id}

Path parameters

id*string (uuid)

Response

200403404

Successfully retrieved the avatar

Body

image/jpegimage/pngimage/svg+xml

string (binary)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/avatar/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

binary

Create an avatar associated with a user ID.

POSThttps://localhost:16001/api/v1/avatar/{id}

Path parameters

id*string (uuid)

Body

image/jpegimage/pngimage/svg+xml

User id and password

string (binary)

Response

200403404

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/avatar/{id}', {
    method: 'POST',
    headers: {
      "Content-Type": "image/jpeg"
    },
    body: JSON.stringify("binary"),
});
const data = await response.json();

Response

200403404

{
  "Operation": "text",
  "Details": "text"
}

Remove an avatar associated with a user ID.

DELETEhttps://localhost:16001/api/v1/avatar/{id}

Path parameters

id*string (uuid)

Response

204403404

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/avatar/{id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

204403404

{
  "Operation": "text",
  "Details": "text"
}

Send test email with the system.

POSThttps://localhost:16001/api/v1/email

Body

application/json

The requested message

fromstring (email)

subjectstring

recipientsarray of string (email)

textstring

Response

200403404500

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/email', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200403404500

{
  "Operation": "text",
  "Details": "text"
}

Send test email with the system.

POSThttps://localhost:16001/api/v1/sms

Query parameters

Body

application/json

The requested message

fromstring

tostring

textstring

Response

200403404500

The requested operation was performed.

Body

application/json

Operationstring

Detailsstring

Codeinteger

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/sms', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200403404500

{
  "Operation": "text",
  "Details": "text"
}

Retrieve the list of security profiles for a specific service type.

GEThttps://localhost:16001/api/v1/securityProfiles

Query parameters

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/securityProfiles', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Retrieve the basic system information. This information is used between services only.

GEThttps://localhost:16001/api/v1/systemServices

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/systemServices', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Allows any microservice to validate a token and get security policy for a specific user.

GEThttps://localhost:16001/api/v1/validateToken

Query parameters

Response

200403404

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/validateToken?token=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

403404

{
  "ErrorCode": 0,
  "ErrorDetails": "text",
  "ErrorDescription": "text"
}

Retrieve different values from the running service.

GEThttps://localhost:16001/api/v1/system

Query parameters

Response

200403404

Successful command execution

Body

application/json

one of

SystemInfoResults (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/system?command=info', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200403404

{
  "version": "text",
  "os": "text",
  "hostname": "text",
  "certificates": [
    {
      "filename": "text"
    }
  ]
}

Perform some system wide commands.

POSThttps://localhost:16001/api/v1/system

Body

application/json

Command details

one of

SystemCommandSetLogLevel (object)SystemCommandReload (object)SystemCommandGetLogLevels (object)SystemCommandGetLogLevelNames (object)SystemCommandGetSubsystemNames (object)

Response

200403404

Successful command execution

Body

application/json

one of

SystemGetLogLevelsResult (object)SystemCommandGetLogLevelNamesResult (object)SystemGetSubSystemNemesResult (object)

Request

JavaScriptCurlPython

const response = await fetch('https://localhost:16001/api/v1/system', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200403404

{
  "taglist": [
    {
      "tag": "text",
      "value": "text"
    }
  ]
}