场景更新

更新时间：2025-10-20 09:55:31

调用该接口更新场景。开发参考见 场景自动化开发指南

---

描述	值
路径	/platform/scene/update
版本号	1.0.0
协议	HTTPS
请求方法	POST

请求参数：

公共请求参数见 公共请求参数

请求字段	类型	必选	描述
openId	String	是	三方用户外标id
sceneId	Long	是	场景id
enable	Bool	是	是否在创建时启用场景。true（表示启用）；false（表示停用）。
name	String	是	用户给场景起的名称
mode	String	是	any：表示任何一个条件满足就执行动作。all：表示所有条件满足时才执行动作。默认any，目前只支持any
conditions	List	是	条件列表
uri	String	是	condition/device/property：属性规则，condition/device/event：事件规则
params	Struct	是	条件规则参数
productKey	String	是	产品的Key，设备证书信息之一。
deviceName	String	是	设备的名称，设备证书信息之一。
identifier	String	是	物模型属性或事件标识符。
propertyName	String	否	对应属性或事件参数名称
compareType	String	是	比较类型，如>、<、>=、==、<=、!=、in
compareValue	Object	是	比较的值。
actions	List	是	动作列表
uri	String	是	action/device/setProperty: 属性设置，action/device/invokeService：服务调用
params	Struct	是	条件规则参数
productKey	String	是	产品的Key，设备证书信息之一。
deviceName	String	是	设备的名称，设备证书信息之一。
identifier	String	是	物模型属性或服务标识符。
args	String	是	属性设置的内容或者服务入参，无入参填 {}。

返回参数：

返回字段	类型	描述
id	String	用于识别请求记录，即对应的请求ID。
code	Int	接口返回码字段，请求成功时返回200；请求失败时返回详细的错误码。
message	String	调用失败时，返回的出错信息

请求示例：

x-ca-key: xxxxxxxx
x-ca-timestamp: 1728634151000
x-ca-nonce: 7b25fc15b9434dd98587a077a92b7e42
x-ca-signature: yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy
Content-Type: application/json;charset=UTF-8

{
    "id": "49a7be925e******9b08ba0facf7",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0"
    },
    "params": {
        "openId": "op******1",
        "sceneId": 1,
        "enable": true,
        "name": "111222223",
        "mode": "any",
        "conditions": [
            {
                "uri": "condition/device/property",
                "params": {
                    "compareValue": "2",
                    "identifier": "AlarmFrequencyLevel",
                    "compareType": "==",
                    "propertyName": "level",
                    "productKey": "xL******udl",
                    "deviceName": "qc*****t1"
                }
            }
        ],
        "actions": [
            {
                "uri": "action/device/invokeService",
                "params": {
                    "productKey": "xL******udl"
                    "deviceName": "de******g",
                    "identifier": "QueryRecordTimeList",
                    "args": "{}"
                }
            }
        ],
    }
}

成功返回示例：

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
    "id": "49a7be925e******9b08ba0facf7",
    "code": 200,
    "message": "success"
}