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

Get gateway data

This request delivers data about a gatway. Also useful to check if a gateway exists.

API endpoint

gateway/slcHardwareID of gateway

Request method

GET

Request headers

-

Request URL parameters

-

Response content

EntityTypeNullableDescription
gatewayarray (mainEntity)no

mainEntity

EntityTypeNullableDescription
idintnoslcID of gateway
hw_idstringnoslcHardwareID of a gateway
namestringyesname
customer_idintnoslcID of customer
latitudefloatnolatitude (WGS84)
longitudefloatnolongitude (WGS84)
rf_channelbytenocurrent rf channel (0-3)
rf_pinushortnocurrent rf pin code (0-9999)
env_brightness_masterboolyestrue if this device is acting as environment brightness master
ext_out_configarray[4] (gatewayExtOutConfig)noconfiguration of logical output (0-4 entries)

gatewayExtOutConfig[]

EntityTypeNullableDescription
output_typeint (outputType)notype of output
namestringyesFrei definierbarer Name der logischen Ausgangs-Konfiguration
physical_outputsbyte[4] - 0-4 entriesnoZeigt auf einen oder mehrere physikalische, nicht invertierende Ausgänge (0-3); Im Latching-Modus sind dies die "Ein / On"-Ausgänge
physical_inv_outputsbyte[4] - 0-4 entriesnoZeigt auf einen oder mehrere physikalische, invertierende Ausgänge (0-3); Im Latching-Modus sind dies die "Aus / Off"-Ausgänge
pulse_durationintnoPuls-Dauer für gepulste-Ausgänge (Latching) in ms (default = 1000ms)
pulse_repeat_intervalintyesPuls-Wiederholdauer (Latching) in ms (Default = 10000ms)
state_feedback_inputbyteyesId (2-3) des externen Erweiterungseingangs für die Statusrückführung (PulseFeedback-Typ) 2-3: Digital Eingang (ExtIn 3 oder 4)
state_feedback_input_invertedboolyesDefiniert, ob der Status-Feedback-Eingang invertiert werden soll.
operationMode_typeint (operationModeType)noTyp des Ausgangs-Betriebsmodus
default_stateboolyesDefault-Ausgangsstatus (ein/aus) für die Modi: Const (0); Time (1); TimeAndBrightness (3); TimeOrBrightness (4); Manual (8); Central Control (9)
env_brightness_onbyteyesEinschaltpunkt im Umgebungshelligkeits-Modus (Roh-Wert)
env_brightness_offbyteyesAusschaltpunkt im Umgebungshelligkeits-Modus (Roh-Wert)
time_slicesarray[32] (gatewayExtOutTimeSlice)yesIm Time-Modus (2, 4, 5): Zeit/Wochentags-Zeitschlitz (1-32 Einträge)
ainput_on_valuefloatyesEinschaltpunkt des Analogen Erweiterungs-Eingangs (in Volt)
ext_inputbyteyesId (0-3) des externen Erweiterungseingangs im DInput oder AInput-Modus: 0-1: Analog Eingang (ExtIn 1 oder 2) 2-3: Digital Eingang (ExtIn 3 oder 4)

gatewayExtOutTimeSlice[]

EntityTypeNullableDescription
daysbyte (flags)noWeekday(s) when this time slice is active
output_stateboolnoAusgangsstatus (true = high; false = low) während dieser Zeitschlitz aktiv ist
start_timetimenostart time of this time slice
end_timetimenoend time of this time slice
start_datedateyesStart date of this time slice. Wenn null => Nur nach Zeit / Wochentage
end_datedateyesEnd date of this time slice. Wenn null => Nur nach Zeit / Wochentage

outputType

ValueDescription
0Static
1Latching
2PulseFeedback

operationModeType

ValueDescription
0Permanent aus- / ausgeschaltet (Konstanter Wert)
1Nach Datum / Zeit / Wochentag
2Nach Umgebungshelligkeit
3Nach Zeit und Umgebungshelligkeit
4Nach Zeit oder Umgebungshelligkeit
5Nach digitalem Erweiterungs-Eingang
6Nach digitalem Erweiterungs-Eingang (invertiert)
7Nach analogem Erweiterungs-Eingang
8Manuell mit virtuellem Schalter (auf Gateway)
9Zentral (von der Webanwendung) kontrolliert: Jobs => ein / aus

Response: example in XML

n.a.

Response: example in JSON

{
	"gateway": {
		"id": 48,
		"hw_id": "8119905F-ED5AD56C-89860823-A1FA05CE",
		"name": "Demo Hess",
		"customer_id": 10,
		"latitude": null,
		"longitude": null,
		"rf_channel": 0,
		"rf_pin": 0,
		"env_brightness_master": false,
		"ext_out_config": []
	}
}