触发自动化外部条件

更新时间:2023-12-07 03:33:54下载pdf

本文介绍触发自动化外部条件的 API。

接口描述

触发家庭中自动化场景的外部条件。

接口地址

POST: /v1.0/homes/{home_id}/automations/{automation_id}/conditions/trigger

请求参数

参数名类型参数位置是否必填说明
home_idStringuritrue用户家庭 ID。
automation_idStringuritrue自动化场景 ID。

body 说明

参数名类型参数位置是否必填说明
entity_idStringbodytrue外部条件对应 ID。
displayJSONbodytrue条件。

display 说明

参数名类型参数位置是否必填说明
codeStringbodytrue设备的 statusCode
valueStringbodytruecode 的取值。

返回参数

参数名类型说明
resultBoolean场景触发是否成功。成功则返回 true

请求示例

POST: /v1.0/homes/242****/automations/53IYSXI3gEn2w***/conditions/trigger
[
  {
    "entity_id": "c9a5a524-d973-4b59-9390-0dcda0f17***",
    "display": {
      "code": "test",
      "value": "test"
    }
  }
]

返回示例

{
    "result": true,
    "t": 1541072348540,
    "success": true
}

错误码

参考 错误码