Zum Hauptinhalt springen
CloudStudio

Generische Sensoren

Melden eines generischen Sensorwerts

Die HTTP-Integration generischer Sensoren verwendet die folgende Struktur:

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

{
	"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"endpointID": 1,
	"value": 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
valueValor genérico. La unidad de medida dependerá de lo que se establezca en la configuración del tipo de variable correspondiente al endpoint.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

Melden eines Werts im "raw"-Format

Der generische Sensorwert 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/UpdateGenericSensorStatusRaw HTTP/1.1
Host: gear.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. La expresión debe devolver un valor numérico. La unidad de medida dependerá de lo que se establezca en la configuración del tipo de variable correspondiente al endpoint.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