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 luminaire points

Update one or more luminaire points.

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

API endpoint

luminairePoint/slcID of customer

Request method

PUT

Request headers

-

Request URL parameters

-

Request content

EntityTypeNullableDescription
luminairePointarray (mainEntity)no

mainEntity

EntityTypeNullableDescription
idintnoslcID of luminaire point
namestringyesname of luminaire point
fidstringyesfid
coordsarray (coords)nolocation
street_numberstringyesstreet / house number
lotstringyeslot
remarksstringyesremarks
ownerstringyesowner
maintenancestringyesmaintenance
linkstringyesfully qualified url
stateintyesoperation state: 0 (n.a.) | 1 (in operation) | 2 (standing idle) | 3 (projected)

coords

EntityTypeNullableDescription
latitudestringyeslatitude (WGS84)
longitudestringyeslongitude (WGS84)
xstringyesx (LV95)
ystringyesy (LV95)

Request: example in XML

n.a.

Request: example in JSON

{
	"luminairePoint": [{
		"fid": 1759,
		"name": "11"
	}, {
		"fid": 1792,
		"name": "12"
	}]
}

Response on sucess

Headers

204 No Content

Content (example)

n.a.

Response on error

Headers

400 Bad Request

Content (example)

{
	"error": 1000
}

Error Codes

CodeDescription
1000no customer selected
1001not a valid json
1002customer does not exist or you do not have access