获取手动智能联动列表

最近更新时间:2023-07-14 16:01:49

我的收藏

1. 接口描述

接口请求域名: iot.cloud.tencent.com/api/exploreropen/appapi。 本接口(AppGetSceneList)用于获取手动智能联动列表。

2. 输入参数

名称
类型
必选
描述
AccessToken
String
公共参数,用户通过微信号、手机或邮箱账号登录成功后,获取的访问 Token。
RequestId
String
公共参数,唯一请求 ID,可自行生成,推荐使用 uuid。定位问题时,需提供该次请求的 RequestId。
Action
String
公共参数,本接口取值:AppGetSceneList。
FamilyId
String
家庭 ID。
Offset
Int
消息偏移量。
Limit
Int
最大返回消息条数,最大值为 50。

3. 输出参数

名称
类型
描述
RequestId
String
公共参数,唯一请求 ID,与入参相同,定位问题时,需提供该次请求的 RequestId。
SceneList
Array of Scene
手动智能联动列表。
Total
Int
手动智能联动总数。

4. 示例

输入示例
POST https://iot.cloud.tencent.com/api/exploreropen/tokenapi HTTP/1.1
content-type: application/json
{
"AccessToken": "***v2",
"RequestId": "req_1",
"Action": "AppGetSceneList",
"FamilyId": "f_9b309********4c3d9588fcc1",
"Offset": 0,
"Limit": 10
}
输出示例: 成功
{
"Response": {
"RequestId": "req_1",
"SceneList": [
{
"SceneId": "s_f7feb440d******28f3a598d00c",
"FamilyId": "f_9b309d8******a11b4c3d9588fcc1",
"SceneName": "f****na",
"SceneIcon": "",
"Actions": [ // Actions数组中的每项的字段,为空则不出现
{
"ActionType": 0,
"ProductId": "R32****0EU",
"DeviceName": "df****yY",
"Data": "{\\"brightness\\": 25}",
"AliasName": "1***45" // 说明:AliasName为设备别名 。
},
{
"ActionType": 1,
"Data": "100"
}
],
"UserId": "1",
"CreateTime": 1578557536,
"UpdateTime": 1578560598,
"Flag": 0, // Flag :0 为正常的场景,1:场景中的设备异常,不在家庭中
"Status": 0 // 场景运行状态 0未运行,1运行中
}
],
"Total": 1
}
}
// IconUrl为具体设备的url



5. 错误码

错误码
描述
InternalError
内部错误。
InternalError.InternalServerExceptionDB
DB 错误。
InvalidParameterValue
参数取值错误。
InvalidParameterValue.InvalidAccessToken
Token 无效。
InvalidParameterValue.NoPermission
用户对该设备无权限。
UnsupportedOperation.SceneRunInProgress
场景执行中。