场景绑定

更新时间:2023-12-07 03:33:57

本文介绍场景绑定的 API。

接口描述

接口主要适用于场景开关设备。场景开关有相应的开关按钮,每个开关按钮拥有相应的指令。通过该接口,可以将指定的开关指令与场景进行绑定,即场景开关与场景进行关联操作。绑定成功后,通过指令下发接口,可以直接触发场景。

接口地址

POST: /v1.0/devices/{device_id}/scenes/{scene_id}

请求参数

参数名类型参数位置是否必填说明
device_idStringuritrue绑定的设备 ID
scene_idStringuritrue场景 ID

body 说明

参数名类型参数位置是否必填说明
codeStringbodytrue标准指令 Code
valueStringbodytrue指令入参范围

返回参数

参数名类型说明
resultBoolean返回结果

请求示例

POST: /v1.0/devices/6c294c2ad22e4fac2f7qb***/scenes/000***4ecd
{
  "code": "scene_1",
  "value": "scene"
}

返回示例

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

错误码

参考 错误码