Bulk Query Firmware Details by Firmware Key

Last Updated on : 2024-06-13 10:37:58download

Query the firmware details based on the product ID and firmware key on the Tuya Developer Platform. The firmware details include firmware key, protocol type, firmware name in Chinese and English, classification, and ID.

API address

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

Request parameter

Parameter name	Type	IN	Required	Description
product_id	String	query	true	The product ID.
firmware_keys	String	query	true	The list of firmware keys.

Return parameter

Parameter name	Type	Description
result	List	The returned result.

Description of result

Parameter name	Type	Description
firmware_key	String	The firmware key.
communication_types	List	The protocol type. Valid values: `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	The remarks.
firmware_name_en	String	The firmware name in English.
firmware_identification	String	The firmware identifier.
timeout	Integer	The timeout value.
channel_category	Integer	The category of channels. Valid values: `1`: main module firmware. `2`: MCU firmware. `3`: Bluetooth firmware. `4`: Zigbee firmware. `5`: extension firmware.
firmware_id	Long	The firmware ID.
firmware_name_zh	String	The firmware name in Chinese.

Request example

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

Return example

{
    "result": {
        "firmware_key": "key***",
        "firmware_identification": "identification",
        "firmware_id": 999,
        "remark": "Remarks",
        "timeout": 60,
        "channel_category": 0,
        "communication_types": [
            "wifi"
        ],
        "firmware_name_zh": "Firmware name in Chinese",
        "firmware_name_en": "name en"
    },
    "t": 1545278901275,
    "success": true
}

Error code

For more information, see error code.