Get Fixture Status by Fixture

This API retrieves the latest Duration and Functional test results as well as driver status from the emergency driver connected to the sensor. Note that only one emergency driver per sensor is allowed. Use the Fixture ID returned by the Get Sensor Details by Floor API  to send the command to the sensor controlling the fixture.

The response includes driver test results, date, and time when the test results were last updated. Note that the test start and completion time will return null until the test is completed or stopped. A valid start and end time are displayed after the test has been completed.

If the API cannot get the results after trying for 60 seconds, the API displays a timeout message that the sensor took too long to respond. If you are trying to get emergency lighting test results from a non-emergency lighting fixture, the API returns an invalid Fixture ID message. Check to ensure that the sensor is not offline, correct the API syntax, and reissue the call. 

Request

GET https: //{em_ip_address_or_hostname}/ems/api/org/fixture/v1/{fixture-id}/emFixtureStatus

Response

{
   "fixtures": [
     "id": "{fixture-id}",
     "emTestResults": {
       "startTime": "YYYY-MM-DD 24HH:MM",
       "completionTime": "YYYY-MM-DD 24HH:MM",
       "failurestatus": "0-255",
       "emergencyMode": "0-255",
       "emergencyStatus": "0-255",
       "durationResult": "0-255",
       "batteryCharge": "0-255"
     }
  ]
}

Parameters

Sample Code

Send a request to retrieve the latest duration and functional fixture status results from the emergency driver connected to the sensor with Fixture ID '28'.  The API returns the Enlighted Manage test results from the sensor. 

GET https: //10.45.3.19/ems/api/org/fixture/v1/28/emFixtureStatus 

Response

HTTP/1.1 200
Server: Apache-Coyote/1.1
Content-Type: application/json
Content-Length: 241
Date: Sat, 26 Sep 2020 10:36:51 GMT
{
   "fixtures": [
      "id": "28",
      "emTestResults": {
         "startTime": "2020-07-20 21:41",
         "completionTime": "2020-07-20 22:40",
         "failurestatus": "32",
         "emergencyMode": "2",
         "emergencyStatus": "10",
         "durationResult": "116",
         "batteryCharge": "254"
      }
   ]
}