根据固件 key 批量查询固件详情

更新时间:2024-06-13 10:48:03下载pdf

本文介绍根据固件 key 批量查询固件详情的 API。

接口描述

根据开发者平台上的产品 ID 和固件 key,查询固件相关的信息。固件相关的信息例如:固件的固件 key,通讯类型,固件的中英文名称,固件的分类,以及固件的 ID。

接口地址

GET: /v1.0/iot-03/product/firmwares

请求参数

参数名 类型 参数位置 是否必填 说明
product_id String query true productId
firmware_keys String query true firmwareKeys

返回参数

参数名 类型 说明
result List

result 说明

参数名 类型 说明
firmware_key String 固件 key
communication_types List 通讯类型,包含:
  • wifi
  • bluetooth
  • gprs
  • zigbee
  • infrared
  • subpieces
  • nb-iot
  • cable
  • blemesh
  • sigmesh
  • ty-smesh
  • Zwave
  • pl-mesh
  • extension
  • cat1
  • beacon
  • lte-cat4
  • lte-cat10
  • lte-catm
  • thread
  • ty_sask
remark String 备注
firmware_name_en String 固件英文名称
firmware_identification String 固件标识
timeout Integer 超时时间
channel_category Integer 通道号分类。
  • 1:主联网模块固件
  • 2:MCU固件
  • 3:蓝牙固件
  • 4:Zigbee固件
  • 5:扩展固件
firmware_id Long 固件 ID
firmware_name_zh String 固件中文名称

请求示例

GET: /v1.0/iot-03/product/firmwares

返回示例

{
    "result": {
        "firmware_key": "key***",
        "firmware_identification": "identification",
        "firmware_id": 999,
        "remark": "备注",
        "timeout": 60,
        "channel_category": 0,
        "communication_types": [
            "wifi"
        ],
        "firmware_name_zh": "固件中文名称",
        "firmware_name_en": "name en"
    },
    "t": 1545278901275,
    "success": true
}

错误码

参考 错误码