空调联动策略

获取、更新、删除空调联动策略

创建空调联动策略

• Method：POST

• URL：https://www.einfra.cn/wad/ems/v1/api/air-strategy

• 接口描述：为特定ems设备创建空调联动策略，每个设备最多一条策略

• 请求

  • Body参数/airStrategy

    参数	类型	是否必填	描述	范围	样例
    device_uid	string		设备唯一ID	-	xxxxx
    cooling_point	int		空调设置-制冷点（单位：℃）	-	1
    cooling_hysteresis	int		空调设置-制冷回差（单位：℃）	-	1
    heating_point	int		空调设置-加热点（单位：℃）	-	1
    heating_hysteresis	int		空调设置-加热回差（单位：℃）	-	-1
    high_temp_point	int		空调设置-高温点（单位：℃）		1
    low_temp_point	int		空调设置-低温点（单位：℃）		1
    high_humidity_point	int		是 空调设置-高湿点（单位：%）		1

  • 示例

cURL

curl --request POST \
  --url https://www.einfra.cn/wad/ems/v1/api/air-strategy \
  --header 'X-API-Key: YH3kPJ5rKVYH3kPJ5rKVYH3kPJ5rKV' \
  --header 'content-type: application/json' \
  --data '{
    "device_uid": "xxxxx",
    "cooling_point": 1,
    "cooling_hysteresis": 2,
    "heating_point": 3,
    "heating_hysteresis": 4,
    "high_temp_point": 5,
    "low_temp_point": 6,
    "high_humidity_point": 7
}'

Python

Go

• 响应

  • 数据类型：application/json

    参数	类型	是否必填	描述	范围	样例
    code	int		错误码	见下文错误码	0
    message	str		描述	-	策略创建成功
    data	str		详细信息

• 错误码

  HTTP状态码	错误码	描述
  400	100001	参数格式错误
  200		成功

获取空调联动策略列表

• Method：GET

• URL：https://www.einfra.cn/wad/ems/v1/api/air-strategy

• 接口描述：获取空调联动策略列表

• 请求

  • Query参数

    参数	类型	是否必填	描述	范围	样例
    device_uid	str		设备唯一ID	-	xxxxx
    page-size	int		每页设备数量（默认值为50）	[0, ∞]	50
    page	int		页码（默认值 1）	[0, ∞]	1

  • 示例

• 响应

  • 数据类型：application/json

    参数	类型	是否必填	描述	范围	样例
    code	int		错误码	见下文错误码	0
    message	str		错误描述	-	-
    data	listResult		每页设备数量（默认值为50）	-	50

  • listResult

    参数	类型	是否必填	描述	范围	样例
    total	int		总策略数	[0, ∞]	10
    list	[]protectionStrategy		策略列表	-	-

• 错误码

  HTTP状态码	错误码	描述
  400	100001	参数格式错误

修改空调联动策略

• Method：PATCH

• URL：https://www.einfra.cn/wad/ems/v1/api/air-strategy

• 接口描述：根据设备uid修改策略

• 请求

  • Query参数

    参数	类型	是否必填	描述	范围	样例
    device_uid	str		设备唯一ID	-	xxxxx

  • Body参数/airStrategy

• 响应

  • 数据类型：application/json

    参数	类型	是否必填	描述	范围	样例
    code	int		错误码	见下文错误码	0
    message	str		描述	-	策略更新成功

• 错误码

  HTTP状态码	错误码	描述
  400	100001	参数格式错误

同步空调联动策略

• Method：PUT

• URL：https://www.einfra.cn/wad/ems/v1/api/air-strategy/sync

• 接口描述： 同步空调联动策略

• 请求

  • Query参数

  参数	类型	是否必填	描述	范围	样例
  device_uid	str		设备唯一ID	-	xxxxx

• 响应

  • application

参数	类型	是否必填	描述	范围	样例
code	int		错误码	见下文错误码	0
message	str		描述	-	策略更新成功
data	object		同步后的策略

• data：

  参数	类型	是否必填	描述	范围	样例
  device_uid	string		设备唯一ID	-	xxxxx
  cooling_point	int		空调设置-制冷点（单位：℃）	-	1
  cooling_hysteresis	int		空调设置-制冷回差（单位：℃）	-	1
  heating_point	int		空调设置-加热点（单位：℃）	-	1
  heating_hysteresis	int		空调设置-加热回差（单位：℃）	-	-1
  high_temp_point	int		空调设置-高温点（单位：℃）		1
  low_temp_point	int		空调设置-低温点（单位：℃）		1
  high_humidity_point	int		是 空调设置-高湿点（单位：%）		1