空气质量指数 (AQI) 传感器
报告端点状态
的 HTTP 集成 air quality (AQI) sensors使用以下结构:
POST /services/gear/DeviceIntegrationService.svc/UpdateAirQualitySensorStatus HTTP/1.1
Host: gear.cloud.studio
Content-Type: application/json
{
"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"endpointID": 1,
"index": 15,
"timestamp": "2021-02-23T14:55:03"
}参数
| 名称 | 说明 | 数据类型 |
|---|---|---|
| accessToken | 具有更新端点信息权限的访问令牌。更多信息请参见该页面。 | text |
| endpointID | 唯一端点标识符或设备地址与端点地址的组合(格式为 [deviceAddress]:endpointAddress,例如:[device-1234]:1)。这些值可以在端点管理页面找到。 | numeric |
| index | Indica el valor del índice de calidad del aire, el valor deber ser entre 0 a 500, expresada en AQI:0-50: Buena51-100: Moderada101-150: Insalubre para grupos sensibles151-200: Insalubre201-300: Muy insalubre301-500: Peligrosa | numeric |
| timestamp | 可选值,表示与测量对应的 UTC 日期和时间。日期格式必须与日期格式部分指定的格式之一相匹配。如果省略该字段,平台将假定测量对应于当前日期和时间。 | text |
报告ing Status in "raw" Format
端点状态可以以 raw 值 使用 ex按下ion converter. 当设备无法执行转换并发出需要在注入平台前进行转换的值时,此选项很方便。
下面是 raw 格式请求的示例:
POST /services/gear/DeviceIntegrationService.svc/UpdateAirQualitySensorStatusRaw HTTP/1.1
Host: gear.cloud.studio
Content-Type: application/json
{
"accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"endpointID": 1,
"rawData": "15",
"timestamp": "2021-02-23T14:55:03"
}参数
| 名称 | 说明 | 数据类型 |
|---|---|---|
| accessToken | 具有更新端点信息权限的访问令牌。更多信息请参见该页面。 | text |
| endpointID | 唯一端点标识符,可以在端点管理页面找到。 | numeric |
| rawData | Value reported by the sensor, as text. An ex按下ion must be specified in the ex按下ion converter. La expresión debe devolver un valor numérico indicando la calidad del aire (entre 0 a 500), expresada en AQI.0-50: Buena51-100: Moderada101-150: Insalubre para grupos sensibles151-200: Insalubre201-300: Muy insalubre301-500: Peligrosa | text |
| timestamp | 可选值,表示与测量对应的 UTC 日期和时间。日期格式必须与日期格式部分指定的格式之一相匹配。如果省略该字段,平台将假定测量对应于当前日期和时间。 | text |