有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

1. 接口描述

接口请求域名: iot.cloud.tencent.com/api/exploreropen/tokenapi 本接口(awesome_everyday)用于获取每日推荐歌单。

2. 输入参数

名称
类型
必选
描述
AccessToken
String
公共参数,AccessToken 用于对一个已经登录的用户鉴权。
RequestId
String
公共参数,唯一请求 ID,可自行生成,推荐使用 uuId。定位问题时,需提供该次请求的 RequestId。
Action
String
公共参数,本接口取值:AppKugouUserCommand。
KGCommand
String
子命令,本接口取值:awesome_everyday。
DeviceId
String
设备Id 由产品 ID 和设备 Name 组成。
KugouParams
子命令的参数。

3. 输出参数

名称
类型
描述
RequestId
String
公共参数,唯一请求 ID,与入参相同,定位问题时,需提供该次请求的 RequestId。
ErrorCode
Integer
请求返回的错误码,0为没有错误。
ErrorMsg
String
请求返回的错误信息。
Data
返回结果。

4. 示例

示例1

输入示例
POST https://iot.cloud.tencent.com/api/exploreropen/tokenapi HTTP/1.1
content-type: application/json
{
"RequestId": "test0191119-012345",
"Action": "AppKugouUserCommand",
"AccessToken": "8b4a70dd16105f******************18edd4e78a3bb8ec",
"DeviceId": "LAEG4YJE1A/dev01",
"KGCommand": "awesome_everyday",
"KugouParams": {...}
}

输出示例: 成功
{
"Response": {
"Data": {...
},
"ErrorCode":0,"ErrorMsg":"",
"RequestId": "keyi20191119-012345"
}
}

5. 错误码

错误码
描述
InternalError
内部错误。
InvalidParameterValue
参数取值错误。
InvalidParameterValue.InvalidAccessToken
Token 无效。
InvalidParameterValue.InternalRPCError
调用超时。
ResourceNotFound
资源不存在。
ResourceNotFound.DeviceNotExist
设备未创建或是已删除。
ResourceNotFound.StudioProductNotExist
产品尚未创建或已被删除。
ResourceNotFound.AppNotExists
应用未创建或是已删除。
UnsupportedOperation
不支持的操作。
UnsupportedOperation.DeviceNotGateway
不是网关设备。
UnsupportedOperation.NotBindVirtualDevice
无法绑定虚拟设备。
UnsupportedOperation.DeviceNotBind
子设备未绑定到网关设备。
UnsupportedOperation.CannotBindSameFamily
该设备已经绑定请勿重复绑定。
LimitExceeded
超出限制。
LimitExceeded.FamilyDeviceExceedLimit
设备数量超出限制。
UnauthorizedOperation
无权操作。
UnauthorizedOperation.APPNoPermissionToStudioProduct
App 对操作该产品无权限。