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

1. 接口描述

接口请求域名:iot.cloud.tencent.com/api/exploreropen/tokenapi。 本接口(AppUpdateDeviceInFamily)用于修改设备名称。

2. 输入参数

名称
类型
必选
描述
AccessToken
String
公共参数,AccessToken 用于对一个已经登录的用户鉴权。
RequestId
String
公共参数,唯一请求 ID,可自行生成,推荐使用 uuId。定位问题时,需提供该次请求的 RequestId。
Action
String
公共参数,本接口取值:AppUpdateDeviceInFamily。
ProductId
String
产品 ID。
DeviceName
String
设备名称。
AliasName
String
设备别名。

3. 输出参数

名称
类型
描述
RequestId
String
公共参数,唯一请求 ID,可自行生成,推荐使用 uuId。定位问题时,需提供该次请求的 RequestId。
DeviceId
String
设备 ID。
ProductId
String
产品 ID。
DeviceName
String
设备名称。
AliasName
String
设备别名。
IconUrl
String
图标 URL。
FamilyId
String
家庭 ID。
RoomId
String
房间 ID。
CreateTime
Int64
创建时间。
UpdateTime
Int64
更新时间。

4. 示例

输入示例
POST https://iot.cloud.tencent.com/api/exploreropen/tokenapi HTTP/1.1
content-type: application/json
{
"RequestId": "641150a3-4238-430d-888b-c01b11298351",
"Action": "AppUpdateDeviceInFamily",
"AccessToken":"xxxv2",
"ProductId": "VZS14OZSN5",
"DeviceName": "~virtualDev",
"AliasName": "12345"
}
输出示例:成功
{
"Response": {
"Data": {
"DeviceId": "R32ONVL0EU/df2eSJyY",
"ProductId": "R32ONVL0EU",
"DeviceName": "df2eSJyY",
"AliasName": "12345",
"IconUrl": "",
"FamilyId": "",
"RoomId": 0,
"CreateTime": 1574859101,
"UpdateTime": 1574859144
},
"RequestId": "641150a3-4238-430d-888b-c01b11298351"
}
}

5. 错误码

错误码
描述
InternalError
内部错误。
InvalidParameterValue
参数取值错误。
InvalidParameterValue.InvalidAccessToken
Token 无效。