- DarkLight
System Information
- DarkLight
Overview
This API allows the Agent to get information about the Finesse system - information like time zone, Finesse server, etc.
Pre-requisite
The application must be registered with the Cisco channel.
Sequence Diagram

Message Structure
Request Parameters | Value |
|---|---|
channel | Cisco |
topic | General |
subtopic | GetSystemInfo |
source | «app-name-broadcasting-this-message» |
data | «JSON Object» |
Data Parameters
Parameter | Data Type | Description | Sample Value |
|---|---|---|---|
No request parameters |
Response Parameters
Response Parameters | Value |
|---|---|
channel | Cisco |
topic | General |
subtopic | SetSystemInfo |
message | «JSON Object» |
Message Parameters
Parameter | Data Type | Sample Value |
|---|---|---|
packet | String | apierror |
systeminfo | JSON Object | NA |
currentTimestamp | String | 2022-05-05T07:34:07.188Z |
timeDiffSeconds | long | 6.812 |
deploymentType | String | UCCE |
lastCTIHeartbeatStatus | String | Success |
lastSuccessCTIHeartbeatTime | String | 1651736045266 |
ctiVersion | String | 23 |
ctiHeartbeatInterval | String | 2 |
peripheralId | String | 5000 |
primaryNode | JSON Object | NA |
host | String | fin125comb.Acqueonlab.com |
secondaryNode | JSON Object | NA |
host | String | fin125comb.Acqueonlab.com |
status | String | IN_SERVICE |
systemAuthMode | String | NON_SSO |
timezoneOffset | String | 330 |
uri | String | /finesse/api/SystemInfo |
xmppDomain | String | fin125comb.Acqueonlab.com |
xmppPubSubDomain | String | pubsub.fin125com.Acqueonlab.com |
Sample Request
{
"channel": "Cisco",
"topic": "General",
"subtopic": "GetSystemInfo"
}Sample Response
{
"channel": "Cisco",
"topic": "General",
"subtopic": "GetSystemInfo",
"message":
{
"packet": "system",
"systemInfo":
{
"currentTimestamp": "2022-05-05T07:34:07.188Z",
"timeDiffSeconds": 6.812,
"deploymentType": "UCCE",
"lastCTIHeartbeatStatus": "success",
"lastSuccessCTIHeartbeatTime": "1651736045266",
"ctiVersion": "23",
"ctiHeartbeatInterval": "2",
"peripheralId": "5000",
"primaryNode":
{
"host": "fin125com.Acqueonlab.com"
},
"secondaryNode":
{
"host": "fin125comb.Acqueonlab.com"
},
"status": "IN_SERVICE",
"systemAuthMode": "NON_SSO",
"timezoneOffset": "330",
"uri": "/finesse/api/SystemInfo",
"xmppDomain": "fin125com.Acqueonlab.com",
"xmppPubSubDomain": "pubsub.fin125com.Acqueonlab.com"
}
}
}