调用该接口更新设备的预约定时场景。

路径 /scene/timing/update
版本号 1.0.5
协议 HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 15000

请求参数

名称 类型 是否必选 示例值 描述
associatedId String testDeviceIotId 场景关联的ID。可传入设备ID、控制组ID。传入设备ID则定时与设备关联;传入控制组ID则定时与控制组关联。
idType String DEVICE 场景关联ID的类别。可传入:DEVICE(表示定时属于设备);CONTROL_GROUP(表示定时属于控制组)。
sceneId String testSceneId 待更新场景的ID。
enable Boolean true 是否启用场景。true(表示启用);false(表示关闭)。
name String 测试云端预约定时 场景名称。不能为空,最长不超过 64 个字符。
icon String http://www.xxx.com/xxx.png 场景图标的链接。
description String 这是一个预约定时场景 对场景的描述。
triggers Struct {"items":[{"params":{"cron":"0 30 9 9 2 ? 2020","cronType":"quartz_cron","timezoneID":"Asia/Shanghai"},"uri":"trigger/timer"}],"uri":"logical/or"} 场景的触发器。
conditions Struct {} 场景的过滤条件。
actions List [{"params":{"iotId":"testDeviceIotId","propertyName":"PowerSwitch","propertyValue":1},"uri":"action/device/setProperty"}] 场景的执行动作,不可为空。

返回数据

名称 类型 示例值 描述
code Int

接口返回码。200表示成功。

message String

调用失败时,返回的出错信息。

localizedMsg String

本地语言的错误消息。

data String

被更新的场景ID。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.5",
		"iotToken": "token"
	},
	"params":{
		"associatedId": "testDeviceIotId",
		"idType": "DEVICE",
		"sceneId": "testSceneId",
		"enable":true,
		"name": "测试云端预约定时",
		"icon": "http://www.xxx.com/xxx.png",
		"description": "这是一个预约定时场景",
		"triggers":{
			"items":[
				{
					"params":{
						"cron": "0 30 9 9 2 ? 2020",
						"cronType": "quartz_cron",
						"timezoneID": "Asia/Shanghai"
					},
					"uri": "trigger/timer"
				}
			],
			"uri": "logical/or"
		},
		"conditions":{},
		"actions":[
			{
				"params":{
					"iotId": "testDeviceIotId",
					"propertyName": "PowerSwitch",
					"propertyValue":1
				},
				"uri": "action/device/setProperty"
			}
		]
	}
}

正常返回示例

JSON 格式

{
    "id": "4de2c367-c1db-417c-aa15-8c585e595d92",
    "code": 200,
    "message": null,
    "localizedMsg": null,
    "data": "testSceneId"
}

异常返回示例

JSON 格式

{
    "id": "37f7e5fa-d6a5-4efe-8abf-5bf23dca6284",
    "code": 403,
    "message": "request forbidden.",
    "localizedMsg": "请求被禁止",
    "data": null
}