调用该接口进行智能小组件查询,用于APP场景快捷触发小组件中查询组件信息。

路径 /living/appwidget/list
版本号 1.0.0
协议 HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 5000

请求参数

返回数据

名称 类型 示例值 描述
code Int

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

message String

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

localizedMsg String

本地语言的错误消息。

data JSON

响应的结果。

id String

返回的场景ID。

name String

返回的场景名称。

description String

对场景的描述。

enable Boolean

场景是否启用。true(表示启用);false(表示关闭)。

icon String

场景图标。

iconColor String

场景图标的颜色。

valid Boolean

场景是否有效。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.0",
		"iotToken": "token"
	},
	"params":{}
}

正常返回示例

JSON 格式

{
    "id": "4de2c367-c1db-417c-aa15-8c585e595d92",
    "code": 200,
    "message": null,
    "localizedMsg": null,
    "data": [
  {
  "id": "",
  "name": "",
  "description": "",
  "enable": true,
  "icon": "",
  "iconColor": ""
  }
]
}

异常返回示例

JSON 格式

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