KundenkonfigurationGeräte und EndpointsGeräteGeräteintegrationHTTPHTTP-APISpeicherung von Sensordaten
Betriebsstundenzähler
Die Integration von Betriebsstundenzählern verwendet dieselbe API wie nicht-generische Durchflusssensoren. Der einzige Unterschied ist, dass Betriebsstundenzähler den Zeitfluss melden müssen in Sekunden.
Bericht der akkumulierten Zeit in Sekunden
The integration de run time meters por HTTP uses the following structure, que es idéntica a la de cualquier sensor de flujo:
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
| Name | Description | Data Type |
|---|---|---|
| accessToken | Access token with permissions to update endpoint information. See this page for more information. | text |
| endpointID | Unique 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 |
| summationValue | Valor acumulado de tiempo informado por el sensor, expresado en segundos. | numeric |
| timestamp | Optional 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 |
Bericht der akkumulierten Zeit im „raw"-Format
Accumulated time can be reported as a 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
| Name | Description | Data Type |
|---|---|---|
| accessToken | Access token with permissions to update endpoint information. See this page for more information. | text |
| endpointID | Unique endpoint identifier, which can be found on the endpoint management page. | numeric |
| rawData | Value 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 tiempo acumulado informado por el sensor, expresado en segundos. | text |
| timestamp | Optional 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 |