获取HMI外部变量
功能描述
该接口用于用户获取天气状况,实时气温,空气质量等相关信息。
注:不支持海外地址调用,只支持国内地址。
请求地址:(二选一)
URL1:
[Host Server]/api/hmi/outside/variable?boxNo={boxNo}
URL2:
[Host Server]/api/hmi/{boxId}/outside/variable
地址参数说明
参数名 类型 参数描述 Host Server string 详情见名词解释 请求方式
POST
Headers
参数名 类型 参数描述 Authorization string Bearer+ 空格+登录接口中获得的access_token Body
参数名 参数含义 Aqi 空⽓质量指数 Level 空⽓质量指数等级 Category 空⽓质量指数级别 Pm10 Pm10 Pm25 Pm2.5 No2 ⼆氧化氮 So2 ⼆氧化硫 Co ⼀氧化碳 O3 臭氧 Weather 天⽓现象(汉字描述) Temperature 实时⽓温 Winddirection ⻛向描述 WindPower ⻛⼒级别 Humidity 空⽓湿度 响应成功
返回查询的参数集合JSON对象,单个对象属性如下参数名 类型 参数描述 Status int 1:成功,2:设备未有经纬度,无法调用第三方接口,3:调用第三方接口失败,4:部分成功,部分失败,5: 其他错误 variables array 变量的key-value address object 设备地址,省->市->区 variables属性对象:
参数名 类型 参数描述 name string 传参名称 value string 传参值 address属性对象:
参数名 类型 参数描述 province string 设备地址,省级 city string 设备地址,市级 district string 设备地址,区级 返回状态码
参数名 参数描述 401 accessToken过期 500 接口实现错误 Postman调用示例