位置模型場景聯動

1、查詢場景模版列表

http請求方式: POST

https://iot-cloudapi.clife.cn/v5x/open/api/scene/location/template/list

密鑰類型：僅限項目密鑰

參數說明

參數名稱	是(yes)否必須	字段類型	參數說明
nodeCode	是(yes)	String	位置節點
pager	否	Pager	分頁參數

返回結果

正确的(of)Json返回結果：

{
	"code": 0,
	"data": {
		"pager": {
			"hasPrevPage": false,
			"currPageRows": 10,
			"pageRows": 10,
			"paged": false,
			"pageStartRow": 0,
			"pageIndex": 1,
			"hasNextPage": true,
			"pageEndRow": 9,
			"totalPages": 6,
			"defaultPageRows": 20,
			"totalRows": 56
		},
		"list": [{
			"summary": "數聯02",
			"sceneType": 0,
			"sceneName": "數聯02",
			"pictureUrl": "",
			"sceneId": 1001,
			"sceneDeviceVOList": [{
				"deviceTypeId": 431,
				"productId": 11305,
				"productName": "西門子 10A 智能插座（2USB）/11305"
			}]
		}]
	},
	"msg": "成功"
}
	

字段名稱	字段類型	字段說明
pager	Object	分頁相關信息
list	List	場景模版列表
summary	String	場景簡介
sceneType	Integer	場景類型
sceneName	String	場景名稱
pictureUrl	String	圖片地(land)址
sceneId	Integer	場景ID
sceneDeviceVOList	List	場景設備列表
deviceTypeId	Integer	設備類型ID
productId	Integer	産品ID
productName	Integer	産品名稱

2、查詢場景模版詳情

http請求方式: POST

https://iot-cloudapi.clife.cn/v5x/open/api/scene/location/template/detail

密鑰類型：僅限項目密鑰

參數說明

參數名稱	是(yes)否必須	字段類型	參數說明
sceneId	是(yes)	Integer	場景模版ID

返回結果

正确的(of)Json返回結果：

{
	"code": 0,
	"data": {
		"summary": "全部關全部關",
		"sceneName": "全部關",
		"pictureUrl": "",
		"sceneId": 1235,
		"detail": {
			"conditionInstances": [{
				"deviceTypeId": 12288,
				"conditionName": "海曼智能水浸探測器-狀态",
				"operatorName": "是(yes)",
				"conditionTypeId": 1,
				"conProductId": 12288,
				"deviceTypeName": "海曼智能水浸探測器",
				"conditionValueName": "是(yes)漏水",
				"condtionOptionId": 824,
				"conditionInstanceId": 7439
			}],
			"actions": [{
				"deviceTypeId": 13254,
				"actionsItems": [{
						"functionName": "三路開關",
						"unitCode": "無",
						"configDataField": "Switch_3_OnOff_Null",
						"functionParamName": "關"
					},
					{
						"functionName": "二路開關",
						"unitCode": "無",
						"configDataField": "Switch_2_OnOff_Null",
						"functionParamName": "關"
					},
					{
						"functionName": "一(one)路開關",
						"unitCode": "無",
						"configDataField": "Switch_1_OnOff_Null",
						"functionParamName": "關"
					}
				],
				"actionsType": 1,
				"deviceTypeName": "三路智能開關",
				"actionsId": 5130,
				"actProductId": 13254
			}]
		}
	},
	"msg": "成功"
}
	

字段名稱	字段類型	字段說明
pager	Object	分頁相關信息
list	List	場景列表信息
summary	String	場景簡介
sceneName	String	場景名稱
pictureUrl	String	圖片地(land)址
sceneId	Integer	場景模版ID
detail	Object	場景模版詳情
userConditionInstances	List	場景詳情-條件列表
deviceTypeId	Integer	設備類型ID
conditionName	String	條件名稱
operatorName	String	操作(do)名稱
conditionTypeId	Integer	條件類型ID
conProductId	Integer	産品ID
deviceTypeName	String	條件類型名稱
conditionValueName	String	條件值名稱
condtionOptionId	Integer	條件選項名稱
conditionInstanceId	Integer	條件實例ID
actions	List	場景模版詳情-動作(do)列表
deviceTypeId	Integer	設備類型ID
deviceTypeName	String	設備類型名稱
actionsType	Integer	動作(do)類型
actionsId	String	動作(do)Id
actProductId	String	産品ID
actionsItems	List	動作(do)明細
functionName	String	方法名稱
unitCode	String	單位
configDataField	String	配置數據列
functionParamName	String	方法參數名稱

3、場景模版适配

http請求方式: POST

https://iot-cloudapi.clife.cn/v5x/open/api/scene/location/template/adapt

密鑰類型：僅限項目密鑰

參數說明

參數名稱	是(yes)否必須	字段類型	參數說明
conDeviceIdsStr	否	String	條件對應傳入的(of)設備ID {"conditionInstanceId":"deviceId", ...}
actDeviceIdsStr	是(yes)	String	動作(do)對應傳入的(of)設備ID {"actionsId":"deviceId", ...}
nodeCode	是(yes)	String	位置節點
sceneId	是(yes)	Integer	場景模版Id
userSceneName	是(yes)	String	實例場景名稱

返回結果

正确的(of)Json返回結果：

{
	"code": 0,
	"data": {
		"summary": "C-Life,生(born)活本該如此，暢享智能場景！",
		"sceneId": 0,
		"validity": 1,
		"detail": {
			"userActions": [{
				"pictureUrl": "static/picture/a9283a016c2040b43ec70263eb025a45.png",
				"delayTime": 0,
				"deviceId": "77E5389FC3AD4DECE3C56FBCDCFC63FF",
				"deviceName": "天王蓋地(land)虎WIFI版（普通設備）",
				"userActionsType": 1,
				"userActionsId": 79674,
				"userActionsItems": [{
					"functionParamId": 4237,
					"unitCode": "",
					"configDataField": "Switch",
					"deviceFunctionId": 1623,
					"deviceFunctionName": "開關",
					"functionParamName": "開",
					"actionParamValue": "1"
				}]
			}],
			"userConditionInstances": [{
				"conditionOptionName": "定時(hour)時(hour)間",
				"conditionName": "定時(hour)參數",
				"conditionValueName": "07:00",
				"conditionTypeName": "定時(hour)時(hour)間",
				"repetition": "0,1,2,3,4,5,6,",
				"operatorName": "是(yes)",
				"conditionTypeId": 3,
				"conditionId": 25,
				"userConditionInstanceId": 31687,
				"unitCode": "",
				"conditionValue": "07:00|0,1,2,3,4,5,6,",
				"conditionTypeKey": "TIMMING",
				"timePoint": "07:00",
				"operatorId": 1
			}],
			"expression": "&&",
			"enableTime": "MON,TUE,WED,THU,FRI,SAT,SUN;00:00-23:59"
		},
		"userSceneId": "772303c4704e4906bc2c34401871a9b2",
		"userSceneName": "定時(hour)-07:00開啓設備",
		"runStatus": 1,
		"userSceneType": 0
	},
	"msg": "成功"
}
	

字段名稱	字段類型	字段說明
summary	String	場景簡介
sceneId	Integer	場景模闆ID
validity	Integer	場景是(yes)否有效
userSceneId	String	實例場景ID
userSceneName	String	實例場景名稱
runStatus	Integer	場景狀态
userSceneType	Integer	實例場景類型
detail	Object	實例場景詳情
userActions	List	場景詳情-動作(do)列表
pictureUrl	String	圖片地(land)址
delayTime	String	延遲時(hour)間
deviceId	String	設備ID
deviceName	String	設備名稱
userActionsType	String	動作(do)類型
userActionsId	String	實例動作(do)Id
userActionsItems	List	實例動作(do)明細
functionParamId	Integer	方法參數ID
unitCode	String	單位
configDataField	String	配置數據列
deviceFunctionId	Integer	設備方法ID
deviceFunctionName	String	設備方法名稱
functionParamName	String	方法參數名稱
actionParamValue	String	動作(do)參數值
userConditionInstances	List	場景詳情-條件列表
conditionOptionName	String	條件選項名稱
conditionName	String	條件名稱
conditionValueName	String	條件值名稱
conditionTypeName	String	條件類型名稱
repetition	String	重複執行日期
operatorName	String	操作(do)名稱
conditionTypeId	Integer	條件類型ID
conditionId	Integer	條件ID
userConditionInstanceId	Integer	實例條件實例Id
unitCode	String	單位
conditionValue	String	條件值
conditionTypeKey	String	條件類型key
timePoint	String	時(hour)間節點
operatorId	Integer	操作(do)Id
expression	String	條件表達式
enableTime	String	場景開啓時(hour)間

4、查詢實例場景列表

http請求方式: POST

https://iot-cloudapi.clife.cn/v5x/open/api/scene/location/list

密鑰類型：僅限項目密鑰

參數說明

參數名稱	是(yes)否必須	字段類型	參數說明
nodeCode	是(yes)	String	位置節點
pager	否	Pager	分頁參數

返回結果

正确的(of)Json返回結果：

{
	"code":0,
	"data":{
		"pager":{
			"hasPrevPage":false,
			"currPageRows":5,
			"pageRows":10,
			"paged":false,
			"pageStartRow":0,
			"pageIndex":1,
			"hasNextPage":false,
			"pageEndRow":9,
			"totalPages":1,
			"defaultPageRows":20,
			"totalRows":5
		},
		"list":[
			{
				"summary":"C-Life,生(born)活本該如此，暢享智能場景！",
				"sceneId":0,
				"validity":1,
				"detail":{
					"userActions":[
						{
							"pictureUrl":"static/picture/a9283a016c2040b43ec70263eb025a45.png",
							"delayTime":0,
							"deviceId":"77E5389FC3AD4DECE3C56FBCDCFC63FF",
							"deviceName":"天王蓋地(land)虎WIFI版（普通設備）",
							"userActionsType":1,
							"userActionsId":79674,
							"userActionsItems":[
								{
									"functionParamId":4237,
									"unitCode":"",
									"configDataField":"Switch",
									"deviceFunctionId":1623,
									"deviceFunctionName":"開關",
									"functionParamName":"開",
									"actionParamValue":"1"
								}
							]
						}
					],
					"userConditionInstances":[
						{
							"conditionOptionName":"定時(hour)時(hour)間",
							"conditionName":"定時(hour)參數",
							"conditionValueName":"07:00",
							"conditionTypeName":"定時(hour)時(hour)間",
							"repetition":"0,1,2,3,4,5,6,",
							"operatorName":"是(yes)",
							"conditionTypeId":3,
							"conditionId":25,
							"userConditionInstanceId":31687,
							"unitCode":"",
							"conditionValue":"07:00|0,1,2,3,4,5,6,",
							"conditionTypeKey":"TIMMING",
							"timePoint":"07:00",
							"operatorId":1
						}
					],
					"expression":"&&",
					"enableTime":"MON,TUE,WED,THU,FRI,SAT,SUN;00:00-23:59"
				},
				"userSceneId":"772303c4704e4906bc2c34401871a9b2",
				"userSceneName":"定時(hour)-07:00開啓設備",
				"runStatus":1,
				"userSceneType":0
			}
		]
	},
	"msg":"成功"
}
	

字段名稱	字段類型	字段說明
pager	Object	分頁相關信息
list	List	場景列表信息
summary	String	場景簡介
sceneId	Integer	場景模闆ID
validity	Integer	場景是(yes)否有效
userSceneId	String	實例場景ID
userSceneName	String	實例場景名稱
runStatus	Integer	場景狀态
userSceneType	Integer	實例場景類型
detail	Object	實例場景詳情
userActions	List	場景詳情-動作(do)列表
pictureUrl	String	圖片地(land)址
delayTime	String	延遲時(hour)間
deviceId	String	設備ID
deviceName	String	設備名稱
userActionsType	String	動作(do)類型
userActionsId	String	實例動作(do)Id
userActionsItems	List	實例動作(do)明細
functionParamId	Integer	方法參數ID
unitCode	String	單位
configDataField	String	配置數據列
deviceFunctionId	Integer	設備方法ID
deviceFunctionName	String	設備方法名稱
functionParamName	String	方法參數名稱
actionParamValue	String	動作(do)參數值
userConditionInstances	List	場景詳情-條件列表
conditionOptionName	String	條件選項名稱
conditionName	String	條件名稱
conditionValueName	String	條件值名稱
conditionTypeName	String	條件類型名稱
repetition	String	重複執行日期
operatorName	String	操作(do)名稱
conditionTypeId	Integer	條件類型ID
conditionId	Integer	條件ID
userConditionInstanceId	Integer	實例條件實例Id
unitCode	String	單位
conditionValue	String	條件值
conditionTypeKey	String	條件類型key
timePoint	String	時(hour)間節點
operatorId	Integer	操作(do)Id
expression	String	條件表達式
enableTime	String	場景開啓時(hour)間

5、查詢實例場景詳情

http請求方式: POST

https://iot-cloudapi.clife.cn/v5x/open/api/scene/location/detail

密鑰類型：僅限項目密鑰

參數說明

參數名稱	是(yes)否必須	字段類型	參數說明
nodeCode	是(yes)	String	位置節點
userSceneId	是(yes)	Integer	實例場景ID

返回結果

正确的(of)Json返回結果：

{
	"code": 0,
	"data": {
		"summary": "C-Life,生(born)活本該如此，暢享智能場景！",
		"sceneId": 0,
		"validity": 1,
		"detail": {
			"userActions": [{
				"pictureUrl": "static/picture/a9283a016c2040b43ec70263eb025a45.png",
				"delayTime": 0,
				"deviceId": "77E5389FC3AD4DECE3C56FBCDCFC63FF",
				"deviceName": "天王蓋地(land)虎WIFI版（普通設備）",
				"userActionsType": 1,
				"userActionsId": 79674,
				"userActionsItems": [{
					"functionParamId": 4237,
					"unitCode": "",
					"configDataField": "Switch",
					"deviceFunctionId": 1623,
					"deviceFunctionName": "開關",
					"functionParamName": "開",
					"actionParamValue": "1"
				}]
			}],
			"userConditionInstances": [{
				"conditionOptionName": "定時(hour)時(hour)間",
				"conditionName": "定時(hour)參數",
				"conditionValueName": "07:00",
				"conditionTypeName": "定時(hour)時(hour)間",
				"repetition": "0,1,2,3,4,5,6,",
				"operatorName": "是(yes)",
				"conditionTypeId": 3,
				"conditionId": 25,
				"userConditionInstanceId": 31687,
				"unitCode": "",
				"conditionValue": "07:00|0,1,2,3,4,5,6,",
				"conditionTypeKey": "TIMMING",
				"timePoint": "07:00",
				"operatorId": 1
			}],
			"expression": "&&",
			"enableTime": "MON,TUE,WED,THU,FRI,SAT,SUN;00:00-23:59"
		},
		"userSceneId": "772303c4704e4906bc2c34401871a9b2",
		"userSceneName": "定時(hour)-07:00開啓設備",
		"runStatus": 1,
		"userSceneType": 0
	},
	"msg": "成功"
}
	

字段名稱	字段類型	字段說明
summary	String	場景簡介
sceneId	Integer	場景模闆ID
validity	Integer	場景是(yes)否有效
userSceneId	String	實例場景ID
userSceneName	String	實例場景名稱
runStatus	Integer	場景狀态
userSceneType	Integer	實例場景類型
detail	Object	實例場景詳情
userActions	List	場景詳情-動作(do)列表
pictureUrl	String	圖片地(land)址
delayTime	String	延遲時(hour)間
deviceId	String	設備ID
deviceName	String	設備名稱
userActionsType	String	動作(do)類型
userActionsId	String	實例動作(do)Id
userActionsItems	List	實例動作(do)明細
functionParamId	Integer	方法參數ID
unitCode	String	單位
configDataField	String	配置數據列
deviceFunctionId	Integer	設備方法ID
deviceFunctionName	String	設備方法名稱
functionParamName	String	方法參數名稱
actionParamValue	String	動作(do)參數值
userConditionInstances	List	場景詳情-條件列表
conditionOptionName	String	條件選項名稱
conditionName	String	條件名稱
conditionValueName	String	條件值名稱
conditionTypeName	String	條件類型名稱
repetition	String	重複執行日期
operatorName	String	操作(do)名稱
conditionTypeId	Integer	條件類型ID
conditionId	Integer	條件ID
userConditionInstanceId	Integer	實例條件實例Id
unitCode	String	單位
conditionValue	String	條件值
conditionTypeKey	String	條件類型key
timePoint	String	時(hour)間節點
operatorId	Integer	操作(do)Id
expression	String	條件表達式
enableTime	String	場景開啓時(hour)間

6、通過實例場景ID列表獲取場景

http請求方式: POST

https://iot-cloudapi.clife.cn/v5x/open/api/scene/location/list/ids

密鑰類型：僅支持項目密鑰

參數說明

參數名稱	是(yes)否必須	字段類型	參數說明
userSceneIdList	是(yes)	String	實例場景ID列表，如["4d677871", "4f9ebe395"]

返回結果

正确的(of)Json返回結果：

{
	"code":0,
	"data":[
		{
			"sceneId":0,
			"validity":0,
			"userSceneId":"5b1540488c864625a2b2c005008aeb1e",
			"userSceneName":"智能插座",
			"runStatus":0,
			"userSceneType":1
		},
		{
			"sceneId":873,
			"validity":0,
			"userSceneId":"ea38962f25b34f89a3ad53a087e0b077",
			"userSceneName":"艾美face場景1-用(use)戶離開",
			"runStatus":0,
			"userSceneType":1
		}
	],
	"msg":"成功"
}
		

字段名稱	字段類型	字段說明
sceneId	Integer	場景模闆ID
validity	Integer	場景是(yes)否有效
userSceneId	String	實例場景ID
userSceneName	String	實例場景名稱
runStatus	Integer	場景狀态
userSceneType	Integer	實例場景類型

7、開啓場景

http請求方式: POST

https://iot-cloudapi.clife.cn/v5x/open/api/scene/location/start

密鑰類型：僅限項目密鑰

參數說明

參數名稱	是(yes)否必須	字段類型	參數說明
userSceneId	是(yes)	String	實例場景ID

返回結果

正确的(of)Json返回結果：

{
	"data": true,
	"code": 0
}
		

8、關閉場景

http請求方式: POST

https://iot-cloudapi.clife.cn/v5x/open/api/scene/location/stop

密鑰類型：僅限項目密鑰

參數說明

參數名稱	是(yes)否必須	字段類型	參數說明
userSceneId	是(yes)	String	實例場景ID

返回結果

正确的(of)Json返回結果：

{
	"data": true,
	"code": 0
}
		

9、删除場景

http請求方式: POST

https://iot-cloudapi.clife.cn/v5x/open/api/scene/location/delete

密鑰類型：僅限項目密鑰

參數說明

參數名稱	是(yes)否必須	字段類型	參數說明
userSceneId	是(yes)	String	實例場景ID

返回結果

正确的(of)Json返回結果：

{
	"data": {},
	"code": 0
}