调用该接口查询用户的场景或自动化列表。

路径 /scene/list/get
版本号 1.0.5
协议 HTTP,HTTPS
请求方法 POST
是否需要用户身份鉴权 是
超时时间 5000

请求参数

名称类型是否必选示例值描述
名称 类型 是否必选 示例值 描述
type String 否 业务类型，ilop（代表是生活物联网平台业务）；hc（代表全屋业务）。
pageNo Int 否 当前页号，从1开始。
pageSize Int 是 分页大小。
groupId String 否 场景类型。0 （表示手动场景即 App 上的 “场景”）；1（表示自动场景，即 App 上的 “自动化”）。

返回数据

名称类型示例值描述
名称 类型 示例值 描述
code Int

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

调用失败时，返回的出错信息。
localizedMsg String

本地语言的错误消息。
data JSON

场景列表查询结果。
total Int

符合筛选条件的总条目数。
scenes JSON

返回当前页条目。
id String

场景ID。
status Int

场景的状态。1（表示场景上线）；2（表示场景下线）。
enable Boolean

App上场景开关。true（表示场景置为打开）；false（表示场景置为关闭）。
icon String

场景图标链接。
name String

场景名称。
description String

场景的描述。
iconColor String

场景图标的颜色。
valid Boolean

场景是否有效。
groupId String

场景类型。null（表示老版场景）；0 （表示手动场景即 App 上的 “场景”）；1（表示自动场景，即 App 上的 “自动化”）。
pageNo Int

返回当前页条目，从1开始。
pageSize Int

分页大小。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.5",
		"iotToken": "token"
	},
	"params":{
		"type": "value0",
		"pageNo": "value1",
		"pageSize": "value2",
		"groupId": "value3"
	}
}

正常返回示例

JSON 格式 

{
  "code": 200,
  "data": {
    "pageNo": 1,
    "pageSize": 20,
    "scenes": [{
      "description": "电热毯-hy-信噪比--127 ",
      "enable": true,
      "icon": "https://g.aliplus.com/scene_icons/default.png",
      "id": "260de82dxxxx691be22",
      "name": "电热毯",
      "status": 2,
      "iconColor":"#19BBFF",
      "valid":false,
      "groupId":"1"

    }, {
      "description": "light-hy-LightSwitch-1, shuijin-hy-WiFI_SNR--127 ",
      "enable": true,
      "icon": "https://g.aliplus.com/scene_icons/default.png",
      "id": "45dc6fcxxxx6974e5f7",
      "name": "凉宫",
      "status": 1,
        "iconColor":"#19BBFF",
      "valid":true,
      "groupId":"1"
    }, {
      "description": "fengsan-hy-PowerSwitch-关闭, light-hy-LightSwitch-1 ",
      "enable": true,
      "icon": "https://g.aliplus.com/scene_icons/default.png",
      "id": "3ce636xxxx1367f2dc88",
      "name": "风扇灯0522",
      "status": 1,
       "iconColor":"#19BBFF",
      "valid":false,
      "groupId":"1"
    }, {
      "description": "light-hy-LightSwitch-1 ",
      "enable": true,
      "icon": "https://g.aliplus.com/scene_icons/default.png",
      "id": "5b4bdexxxx2612f81",
      "name": "灯0522",
      "status": 2,
        "iconColor":"#19BBFF",
      "valid":false,
      "groupId":"1"
    }],
    "total": 4
  },
  "message": "success"
}

异常返回示例

JSON 格式 

{}