KundenkonfigurationGeräte und EndpointsGeräteGeräteintegrationHTTPHTTP-APISpeicherung von Sensordaten
Feuchtigkeitssensoren
Meldung der Feuchtigkeit als Prozentsatz
Die HTTP-Integration von Feuchtigkeitssensoren verwendet die folgende Struktur:
POST /services/gear/DeviceIntegrationService.svc/UpdateHumiditySensorStatus HTTP/1.1
Host: gear.cloud.studio
Content-Type: application/json
{
"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"endpointID": 1,
"humidityPercentage": 49,
"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. | text |
| humidityPercentage | Humidity percentage, from 0 to 100. | 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 |
Meldung der Feuchtigkeit im "raw"-Format
Die Feuchtigkeit 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/UpdateHumiditySensorStatusRaw HTTP/1.1
Host: gear.cloud.studio
Content-Type: application/json
{
"accessToken": "",
"endpointID": 1,
"rawData": "49",
"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. The expression must return a numeric value between 0 and 100. | 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 |