空调联动策略

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

创建空调联动策略

• 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

import http.client

conn = http.client.HTTPConnection("https://www.einfra.cn")

payload = "{\n    \"cooling_point\": 1,\n    \"cooling_hysteresis\": 2,\n    \"heating_point\": 3,\n    \"heating_hysteresis\": 4,\n    \"high_temp_point\": 5,\n    \"low_temp_point\": 6,\n    \"high_humidity_point\": 7,\n    \"device_uid\": \"xxxxx\"\n}"

headers = {
    'X-API-Key': "YH3kPJ5rKVYH3kPJ5rKVYH3kPJ5rKV",
    'content-type': "application/json"
    }

conn.request("POST", "/wad/ems/v1/api/air-strategy", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

Go

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.einfra.cn/wad/ems/v1/api/air-strategy"

	payload := strings.NewReader("{\n    \"cooling_point\": 1,\n    \"cooling_hysteresis\": 2,\n    \"heating_point\": 3,\n    \"heating_hysteresis\": 4,\n    \"high_temp_point\": 5,\n    \"low_temp_point\": 6,\n    \"high_humidity_point\": 7,\n    \"device_uid\": \"xxxxx\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "YH3kPJ5rKVYH3kPJ5rKVYH3kPJ5rKV")
	req.Header.Add("content-type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

• 响应

  • 数据类型：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