帮你快速理解、总结文档立即下载
文档中心>物联网开发平台>旧版文档>客户端 API>固件升级>获取设备当前版本信息

获取设备当前版本信息

最近更新时间：2025-12-29 15:26:14
我的收藏

本页目录：

1. 接口描述

接口请求域名：iot.cloud.tencent.com/api/exploreropen/tokenapi。
本接口（AppDescribeDeviceVersion）用于获取设备当前版本。

2. 输入参数

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

3. 输出参数

名称
类型
描述
DeviceVersions
array
返回设备版本数组，请参见 DeviceVersions。
RequestId
string
公共参数，唯一请求 ID，与入参相同，定位问题时，需提供该次请求的 RequestId。

4. 示例

示例1

输入示例
POST https://iot.cloud.tencent.com/api/exploreropen/tokenapi HTTP/1.1
content-type: application/json
{
    "Action":"AppDescribeDeviceVersion",
    "RequestId":"ksdfsdf",
    "AccessToken": "c1******************847e",
    "ProductId": "DBLAWIULBC",
    "DeviceName": "11"
}
输出示例: 成功
{
	"Response": {
		"DeviceVersions": [{
			"Version": "2.0",
			"Module": "mcu"
		}],
		"RequestId": "ksdfsdf"
	}
}

5. 错误码

错误码
描述
InternalError
内部错误。
InvalidParameterValue
参数取值错误。
InvalidParameterValue.InvalidAccessToken
Token 无效。
InvalidParameterValue.NoPermission
用户对该设备无权限。
ResourceNotFound
资源不存在。
ResourceNotFound.DeviceFirmwareTaskNotExist
未查询到固件升级任务。
中国站