V2.5 Report Device Firmware Version


上报设备固件版本。

操作权限


确保已获取调用该 API 的权限。更多信息，参见 获取 API 调用权限。

请求格式

GET https://{apigw-address}/connect-service/v2.5/devices?action=reportFirmwareVersion

请求参数（URI）

名称

位置（Path/Query）

必需/可选

数据类型

描述

orgId

Query

必需

String

资产所属的组织 ID。如何获取 orgId 信息>>

请求参数（Body）

名称

必需/可选

数据类型

描述

version

必需

String

固件版本号。前往 OTA 升级 > 固件管理 中 版本号 列查看固件版本号。

assetId

必需

String

资产ID。如何获取 assetId 信息>>

productKey

必需

String

设备的 product key。如何获取设备的 productKey 信息>>

deviceKey

必需

String

Device Key。如何获取设备的 deviceKey 信息>>

响应参数

名称

数据类型

描述

code

number

更新成功或失败的指示码。

msg

String

成功时返回 OK；其他值则为失败。

requestId

String

每次请求获取的 ID，用于唯一标识一次 API 请求。

错误码

代码

错误信息

描述

400

Invalid Argument

参数错误。

500

OTA Service Internal Error

OTA 服务内部错误。

404

Device Not Found

设备未找到。

示例

请求示例

url: https://{apigw-address}/connect-service/v2.5/devices?action=reportFirmwareVersion&orgId=yourOrgId
method: POST

返回示例

{
    "code": 0,
    "msg": "OK",
    "requestId": "151ddb7a-6352-4069-9ef9-a7eb940c99eb",
    "data": null
}