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.1content-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 | 场景执行中。 |