get-all-firmwares接口
获取云平台上指定设备的所有可用固件。
接口原型
| 协议 |
HTTP/HTTPS GET |
| URL |
ip[:port]/sc_cloud/scapi/get-all-firmwares?dev-type=1&
product-id=770&hardware-ver=A |
| 数据格式 |
响应消息：Content-Type: application/json |
请求URL参数
| 参数 |
是否必选 |
描述 |
| dev-type |
是 |
设备产品族编号。 |
| product-id |
否 |
设备产品编号。 |
| hardware-ver |
否 |
设备硬件版本。 |
当请求URL参数只有dev-type，且dev-type=0时，响应数据为云平台上所有可用的固件。
请求Cookies
| 名称 |
描述 |
| mwcloud-sid |
用于标识当前登录的字符串 |
| mwcloud-uid |
当前登录用户名 |
请求示例
GET /sc_cloud/scapi/get-all-firmwares?dev-type=1&product-id=770&hardware-ver=A HTTP/1.1
Accept: application/json, text/plain, */*
Cookie: mwcloud-sid=OCXWUMGEYPGIAWWOETYXPNMVHDZIAZJP; mwcloud-uid=Admin;
响应参数
| 参数 |
描述 |
| Content-Type |
取值为：'application/json; charset=UTF-8' |
Response Body
firmwares
指定设备的所有可用固件。
| 参数 |
描述 |
| id |
固件ID。 |
| file-path |
固件存放路径。 |
| upload-date |
固件上传时间。 |
| product-id |
设备产品编号。 |
| firmware-id |
固件版本类型。 |
| hardware-ver |
设备硬件版本。 |
| marjor-ver |
主版本号。 |
| minor-ver |
次版本号。 |
| build-number |
构建号。 |
设备固件版本由marjor-ver、minor-ver和build-number组成。
如响应示例中固件版本为1.5.178。
响应示例
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 219
{
"result": 0,
"firmwares": [
{
"id": 21,
"file-path": "/data/firmware/firmware-770-1-A-1.5.178.mwf",
"upload-date": 1635151650,
"product-id": 770,
"firmware-id": 1,
"hardware-ver": "A",
"marjor-ver": 1,
"minor-ver": 5,
"build-number": 178
}
]
}