Zum Hauptinhalt springen
CloudStudio

Temperatursensoren

Meldung der Temperatur in Grad Celsius

Die HTTP-Integration von Temperatursensoren verwendet die folgende Struktur:

POST /services/gear/DeviceIntegrationService.svc/UpdateTemperatureSensorStatus HTTP/1.1
Host: gear-dev.cloud.studio
Content-Type: application/json

{
	"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"endpointID": 1,
	"temperatureCelsius": 45,
	"timestamp": "2021-02-23T14:55:03"
}

Parameter

NameDescriptionData Type
accessTokenAccess token with permissions to update endpoint information. See this page for more information.text
endpointIDUnique endpoint identifier or combination of device address and endpoint address in format [deviceAddress]:endpointAddress (e.g.: [device-1234]:1). These values can be found on the endpoint management page.numeric
temperatureCelsiusMeasured temperature, numeric value greater than or equal to -273.15, indicating the measured temperature in degrees Celsius (C).numeric
timestampOptional value indicating the UTC date and time corresponding to the measurement. The date format must match one of those specified in the date formats section. If the field is omitted, the platform will assume the measurement corresponds to the current date and time.text

Meldung der Temperatur im "raw"-Format

Die Temperatur kann als Rohwert unter Verwendung des Ausdruckskonverters gemeldet werden. Diese Option ist praktisch, wenn das Gerät keine Konvertierungen durchführen kann und Werte ausgibt, die transformiert werden müssen, bevor sie in die Plattform eingefügt werden.

Nachfolgend finden Sie ein Beispiel für eine Anfrage im Rohformat:

POST /services/gear/DeviceIntegrationService.svc/UpdateTemperatureSensorStatusRaw HTTP/1.1
Host: gear-dev.cloud.studio
Content-Type: application/json

{
	"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"endpointID": 1,
	"rawData": "45",
	"timestamp": "2021-02-23T14:55:03"
}

Parameter

NameDescriptionData Type
accessTokenAccess token with permissions to update endpoint information. See this page for more information.text
endpointIDUnique endpoint identifier, which can be found on the endpoint management page.numeric
rawDataValue reported by the sensor, as text. An expression must be specified in the expression converter. The expression must return a numeric value greater than or equal to -273.15, indicating the measured temperature in degrees Celsius (C).text
timestampOptional value indicating the UTC date and time corresponding to the measurement. The date format must match one of those specified in the date formats section. If the field is omitted, the platform will assume the measurement corresponds to the current date and time.text

Zuletzt aktualisiert am

Auf dieser Seite