Info APIs

Keep Alive (GET)

Keeps the connection alive. Default expiry time is 45 min (Release) / 24 hours (Debug).

Route

URI	/api/v1/Info/keepalive
Method	GET
Result	JSON – True if successful.

Parameters

Name	Type	Mandatory	Description
webApplication	WebApplication	No

Example

GET http://localhost/api/v1/Info/keepalive

License Status (GET)

License Status.

Route

URI	/api/v1/Info/License
Method	GET
Result	JSON – object

Parameters

Name	Type	Mandatory	Description
webApplication	WebApplication	No

Example

GET http://localhost/api/v1/Info/License

License Application Values (GET)

Returns an object with information of additional applications or mates from license file section <Applications>.

Route

URI	/api/v1/Info/License/app/{appId}/values
Method	GET
Result	JSON – A object with keys and values of the given appId from the license file.

Parameters

Name	Type	Mandatory	Description
appId	string	Yes	The id of the requested application.
webApplication	WebApplication	No

Example

GET http://localhost/api/v1/Info/License/app/{appId}/values

Version (GET)

Retrieve the tree for a given key element.

Route

URI	/api/v1/Info/version
Method	GET
Result	JSON – AppInfoVersion

Parameters

None

Response Structure Returns AppInfoVersion object containing:

- PnServerVersion: Get the version of the backend 8MAN server.

- ApiVersion: Get the version the this API.

Example

GET http://localhost/api/v1/Info/version

Example Response

{     "PnServerVersion": "sample",     "ApiVersion": 0.0 }

Web Config (GET)

Returns a <see cref="StringComparer.OrdinalIgnoreCase"/> dictionary with a bunch of web client application parameters, formerly saved in config.json.

Route

URI	/api/v1/Info/webconfig
Method	GET
Result	JSON – WebClientConfigModel

Parameters

Name	Type	Mandatory	Description
webApplication	WebApplication	No

Response Structure Returns WebClientConfigModel object containing:

• DefaultDomain: string value

• ShowFeedbackButton: Controls the visibilty of the feedback button.

• AllowTypeIdGrouping: bool value

• UseAppInsights: Controls the usage of insights.

• RequestAdminScenario: string value

• ADInactiveAccountsIncludesNullInactiveDays: bool value

• AllowSso: Controls the possibility of logon with single sign-on.

• RedirectSso: string value

• MaxSearchResults: Class for customization details.

• RetainComments: Maximum number of resource search results

• Customization: Controls if successive comment dialogues retain the value of the previous one.

Example

GET http://localhost/api/v1/Info/webconfig

Example Response

{     "DefaultDomain": "sample",     "ShowFeedbackButton": true,     "AllowTypeIdGrouping": true,     "UseAppInsights": true,     "RequestAdminScenario": "sample",     "ADInactiveAccountsIncludesNullInactiveDays": true,     "AllowSso": true,     "RedirectSso": "sample",     "MaxSearchResults": 1,     "RetainComments": true,     "Customization": {} }