Zum Hauptinhalt springen
CloudStudio

Generische Durchflusssensoren

Die Integration generischer Durchflusssensoren verwendet dieselbe API wie nicht-generische Durchflusssensoren. Der einzige Unterschied ist, dass generische Sensoren den Durchfluss in der Einheit melden müssen, die der dem Sensor zugeordneten generischen Variable entspricht.

Bericht des akkumulierten Durchflusses in Einheiten

The integration de sensores genéricos de flujo por HTTP uses the following structure, que es idéntica a la de los sensores de flujo no-genéricos:

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

{
	"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"endpointID": 1,
	"summationValue": 112685,
	"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
summationValueValor acumulado de flujo informado por el sensor. Las unidades son las mismas que las elegidas para la variable genérica asociada al sensor.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 des akkumulierten Durchflusses im „raw"-Format

Der Durchfluss kann gemeldet werden als Rohwert mit dem Ausdruckskonverter. Diese Option ist sinnvoll, wenn das Gerät keine Konvertierungen vornehmen kann und Werte ausgibt, die transformiert werden müssen, bevor sie in die Plattform eingespeist werden.

Nachfolgend ein Beispiel einer Anfrage im raw-Format:

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

{
	"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
	"endpointID": 1,
	"rawData": "112685",
	"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 indicando el valor acumulado de flujo informado por el sensor, expresado en las unidades de la variable genérica asociada al sensor.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