slControl API

LogoutChangelog (26.08.2024)Legal notesBasic usageRequest EmulatorTroubleshooting
Global
Get list of accessible customersGet lookup tables for settingsGet lookup tables for devicesGet lookup tables for operationModeGet lookup tables for gatewaysGet lookup tables for jobsGet lookup tables for alerts
Customers
Get customer configurationUpdate customer configurationGet mesh network
Groups
Get group tree
Lamp switches
Get lamp switchesUpdate lamp switches
Luminaire points
Get luminaire pointsUpdate luminaire pointsCreate luminaire pointsDelete luminaire points
Devices
Get devicesGet device dataGet device stateUpdate device dataUpdate device operation stateGet operation modeUpdate operation modeDelete deviceDelete devices
Devices - Statistics/Logs
Get radar dataGet motion dataGet device energyGet environmental data
Gateways
Get gatewaysGet gateway dataCreate gatewaysDelete a gateway
Jobs
Get jobs state of a deviceGet job state by slcID
Alerts
Get alertsCreate alertsUpdate alerts

Update device operation state

Update operational state of one or more lamps.

Within a request, all lamps must belong to the same customer. We will not update lamps where the slcID of the customer does not match.

BEWARE:
- if you put a device "operational", "out of service", "damaged" or "in reconstruction" only the state will change.
- if you put another state, the lamp will lose its name, slcDeviceAddress, location in tree and its link to a luminaire point.
- if you set "operational" for a device, the technical state will temporarily change to "unknown" even it was previously known.

API endpoint

deviceOperation/slcID of customer

Request method

PUT

Request headers

-

Request URL parameters

-

Request content

EntityTypeNullableDescription
deviceOperationarray (mainEntity)no

mainEntity

EntityTypeNullableDescription
device_idintnoslcID of device
stateint (state)nostate value

state

ValueDescription
0operational (technical state unknown)
-1in stock
-2under repair
-3out of service
-4damaged
-5in reconstruction
-6projected

Request: example in XML

n.a.

Request: example in JSON

{
	"deviceOperation": [{
		"device_id": 1759,
		"state": -3
	}, {
		"device_id": 1792,
		"state": -2
	}]
}