Device Version List - Get Information and Upgrades - Imou Open Platform

deviceVersionList: Get device version and upgradeable information

Function details

Get device version and upgradeable information.

Request address

https://openapi-[DataCenter].easy4ip.com/openapi/deviceVersionList

Minimum permissions required for sub-account token request

"Permission":"Upgrade" "Resource":"dev:serial number"

Incoming parameter description

Parameter name	Parameter type	Required or not	Default value	Legal value	Parameter description
token	String	Yes			Administrator or sub-account accessToken
deviceIds	String	Yes		"1313131313,364663,af41414"	Device serial number. Batch query is possible, and the device serial numbers are separated by commas, and a maximum of 20 device queries are supported

Sample input

{
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign":"6abf3bc90dbcb21883a2fb24af18574c",
        "time":1603371026,
        "nonce":"4279d75d-742a-4e40-a5a0-5fdd096305f5"
    },
    "id":"e65e61bf-b5c4-4989-850e-808216c00ce9",
    "params":{
        "deviceIds":"TESTQWERXXXX",
        "token":"At_00000ad9e6e87f0142eb92e207aec46a"
    }
}

Return data field description

Field name			Field type	Field description
count			Integer	Total number of returned device lists
deviceVersionList	deviceId		String	Device channel number
	version		String	The current version number of the device
	canBeUpgrade		Boolean	Is it possible to upgrade, true: there is a new version that can be upgraded, and the upgradeInfo field information is returned; false: the upgrade is not possible, and the upgradeInfo field is not required to return
	upgradeInfo	version	String	Upgrade package version number
		description	String	Description of the upgrade package
		packageUrl	String	Upgrade package url address

Sample output

{
    "result":{
        "msg":"Successful operation。",
        "code":"0",
        "data":{
            "count":1,
            "deviceVersionList":[
                {
                    "canBeUpgrade":false,
                    "deviceId":"TESTQWERXXXX",
                    "version":"2.145.1000.0.R.20181112"
                }
            ]
        }
    },
    "id":"e65e61bf-b5c4-4989-850e-808216c00ce9"
}