根据固件 key 查询固件版本信息

更新时间:2024-06-25 01:56:40下载pdf

本文介绍根据固件 key 查询固件版本信息的 API。

接口描述

可以用开发者平台上的产品 ID 和固件 key,获取到这个固件相关的固件版本的信息,例如固件版本相关的生产固件、升级固件文件信息、以及固件版本的上架状态、以及固件版本的类型、和固件版本的唯一标识 ID。

接口地址

GET: /v1.0/iot-03/product/firmware/versions

请求参数

参数名类型参数位置是否必填说明
product_idStringquerytrueproductId
firmware_keyStringquerytruefirmwareKey

返回参数

参数名类型说明
resultList结果集

result 说明

参数名类型说明
remarkString备注信息
filesList固件版本文件信息
gmt_modifiedLong修改时间
firmware_versionString固件版本号
shelf_statusInteger上架状态。
  • 0:未上架
  • 1:上架
  • 2:即将下架
version_typeInteger固件版本类型。
  • 1:普通版本
  • 2:关键版本
firmware_version_idLong固件版本 ID

files 说明

参数名类型说明
nameString文件名称
full_urlString文件地址
typeString文件类型。
  • firmware_production_QIO:QIO 生产固件
  • firmware_production_DOUT:DOUT 生产固件
  • firmware_production:生产固件
  • firmware_upgrade:升级固件
  • firmware_production_SUB:生产次固件
  • firmware_upgradeDiff:用于差分的固件

请求示例

GET: /v1.0/iot-03/product/firmware/versions
{
  "product_id": "***pid",
  "firmware_key": "key****"
}

错误码

参考 错误码