slControl API

LogoutChangelog (12.10.2025)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
Traffic Lights
Update traffic counter

Update device data

Add a new device or actualize an existing one.

API endpoint

device

Request method

POST

Request headers

-

Request URL parameters

-

Request content

EntityTypeNullableDescription
devicearray (mainEntity)no

mainEntity

EntityTypeNullableDescription
idintnoslcDeviceAddress of this device
customer_idintnoslcID of customer
serial_numberstringyesserial number
mac_addressstringyesMAC address
hardware_type_idint (hardwareType)yeshardware type (slControl-module)
hardware_versionstringyesslcDeviceAddress of this device
firmware_versionstringyescurrent firmware version
bootloader_versionstringyescurrent bootloader version
luminaire_type_namestringyesluminaire type name of the device/lamp (defined by lamp manufacturer)
namestringyesname of the device
latitudefloatyeslatitude (WGS84)
longitudefloatyeslongitude (WGS84)
manual_led_brightnessbyteyesLED-Helligkeit im Manuellen Betriebsmodus
env_brightness_masterboolyestrue if this device is acting as environment brightness master
manual_override_switch_groupsbyte[8] - 64 flags, 8 per byteyesÜbergeordneter Lichtschalter-Gruppen-Konfiguration
motion_neighbor_devicesint[]yesNachbargeräte für Bewegungserkennung (max. 16 Einträge)
led_temperature_limitbyteyesLED temperature limit (lamp will be dimmed if reached)
neighbor_rssi_limitsbyteyesMinimale Empfangsstärke der Nachbarleuchten (in dbm)
dali_evg_type_idint (daliType)yestype id of evg
dali_evg_namestringyesName des EVG's (über DALI an Steuerung angehängt)
available_peripherybyte - 1 flag per bit (periphery) yesVerfügbare Peripherie (Flags, siehe Device_Available_Periphery - Tabelle)
ralab_motion_sensor_configarray (ralabMotionSensorConfig)yesKonfiguration für den Ralab Radar-Bewegungssensor
output_configarray (deviceOutputConfig)yesAusgangskonfiguration der Steuerung
lfc_configarray (lfcConfig)yesLichtstrom-Korrektur-Einstellungen (aka LFC, aka CLO) der Leuchte
has_rf_pin_setboolyesHas device RF-PIN set?

ralabMotionSensorConfig

EntityTypeNullableDescription
sensitivitybytenosensitivity of the sensor in %

deviceOutputConfig

EntityTypeNullableDescription
output_typeint (outputType)nooutput type of the controller
fade_off_timefloatnofade off time in ms
fade_on_timefloatnofade on time in ms
min_dim_stepfloatnoAbstufung (Zeiteinheit hängt von Ausgangstyp ab). Typ: 0.001

lfcConfig

EntityTypeNullableDescription
led_lifetimeuintnoLebenszeit der LED-Module [h]
eol_outputbytenoAusgangs-Lichtleistung des LED-Moduls am Ende der Lebenszeit [%]
limiting_factorbytenoLimiting factor of the led output (e.g. max. output percentage) [%]
curve_gammafloat (range: 0.0 - 1.0)noLichstromabnahme des LED-Moduls im Verhältnis der Zeit. Als Annäherung wird eine Gamma-Kurve verwendet. Dieser Wert gibt den Krümmungsfaktor (gamma) an.

hardwareType

ValueDescription
0iLight M5
1iLight S3
2iLight SA
3iLight S3 PWM
4iLight MA
5iLight MP
6iLight SP
7iLight MDA
8iLight SDA
9SLC-(AC/DC)
10SLC-(AC/DC) GPS
11SLC-Core 100
12SLC-Hub 100
13SLC-Hub 101
14SLC-Hub 102
15SLC-Core 102
16SLC-Hub 103
17SLC-Core 103
80SLC-(AC/DC) (Asia)
81SLC-(AC/DC) GPS (Asia)
82SLC-Core 100 (Asia)
83SLC-Hub 100 (Asia)
84SLC-Hub 101 (Asia)
85SLC-Hub 102 (Asia)
86SLC-Core 102 (Asia)
87SLC-Hub 103 (Asia)
88SLC-Core 103 (Asia)
256SLC-Hub 200-C
257SLC-Hub 203-C
288SLC-RC Switch 200-C
289SLC-RC Switch 203-C
512SLC-Hub 200
513SLC-Hub 203
528SLC-Hub 203-G
544SLC-Switch One
560SLC-Core 200
608SLC-Nema 200
640SLC-Analog
65280USB_Stick
65281iLightAccessPointMP
65282iLightAccessPointMSX
65535Unknown

daliType

ValueDescription
0Nicht definiert
1Philips Xi SSR 75W
2Philips Xi SSR 150W
3OSRAM OT 40
4OSRAM OT 60
5OSRAM OT 90
6OSRAM OT 165
7Alle Philips SR Treiber ab Spezifikation 1.2 bis 1.5
8Alle Philips SR Treiber ab Spezifikation 1.5
9Tridonic LCA 30W
10Tridonic LCA 60W
11Tridonic LCA 75W
12Tridonic LCA 120W
13Tridonic LCA 160W

periphery

ValueDescription
0ublox GPS Modul (nur bei SLC-Core100)
1Digitaler LED Temperatur Sensor angeschlossen
2Intelligenter Bewegungsmelder angeschlossen (z.B: Radar)
3EVG DALI 2.0 mit Leistungsmessung
4Digitaler Helligkeits Sensor angeschlossen

Request: example in XML

n.a.

Request: example in JSON

{
	"device": {
		"id": 142635,
		"customer_id": 139,
		"name": "GPS Box Axpo Tegra",
		"latitude": 46.828067779541016,
		"longitude": 9.4250392913818359
	}
}