Get Sensor Profiles¶
The API returns the existing and applicable light profiles that can be assigned to the sensor. The applicable light profiles are child profiles created from the parent template. Each profile is associated with a unique ID called the profile group ID. The group_id returned is used as the primary identifier in other API calls.
Request¶
GET https:/{em_ip_address_or_hostname}/ems/api/org/fixture/v1/getFixtureApplicableProfiles/{fixture_id}
Parameters¶
| Name | Description |
|---|---|
| Request | |
em_ip_address_or_hostname | The Enlighted Manage (EM) IP address or hostname |
fixture_id | Fixture or sensor identifier. Use the Fixture ID returned by the Get Sensor Details by Floor API or in EM, select Facility > Floor in the left panel, Floor Plan tab, and double-click the fixture icon in the floor plan to obtain the Fixture ID. |
| Response | |
id | The fixture or sensor identifier |
name | Sensor name. For example, Sensorxxxxxx |
currentProfile | Displays the name of the existing profile assigned to the sensor |
group_id** | Profile group identifier. The ID of the profile associated with the fixture. |
| (**used as the primary identifier in other API calls) | |
applicableProfiles | Lists profiles derived from the same profile template as the current profile |
Sample Request¶
Request the profile name assigned to the sensor using the Fixture ID returned by the Get Sensor Details by Floor API.
The response below shows that 'Open Office Max 35' light profile is assigned to the fixture with ID ‘28’. The API also returns the list of applicable profiles and their IDs.
GET https://192.80.3.2/ems/api/org/fixture/v1/getFixtureApplicableProfiles/28
Sample Response¶
{
"id": "28",
"name": "Sensor00ceed",
"currentProfile": "Open Office Max 35",
"groupId": "27",
"applicableProfiles": [
{
"name": "Open Office Max 35",
"groupId": "27"
},
{
"name": "Open Office Max 70",
"groupId": "28"
},
{
"name": "Open Office Max 50",
"groupId": "29"
},
{
"name": "default.Open Office_Normal",
"groupId": "46"
},
{
"name": "default.Open Office_AlwaysOn",
"groupId": "47"
},
{
"name": "default.Open Office_Dim",
"groupId": "48"
}
]
}