Appearance
获取设备蓝牙固件升级版本
接口说明
获取设备蓝牙固件升级版本,只查询正式版本,配置多个正式版本只查询最新的升级版本
请求 URL
本接口通用参数里面 method 的值为 jimi.open.device.queryBtUpgradeVersion
HTTP 请求方式
GET/POST
请求参数
(1) 通用参数
参见:通用参数
(2) 私有参数
| 参数名称 | 参数类型 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|---|
| access_token | String | 是 | 访问令牌,表明其是一个合法第三方 | |
| imei | String | 是 | 无 | 设备 imei 号 |
返回值
| 参数 | 类型 | 描述 |
|---|---|---|
| code | Int | 返回码: 0: 正确返回 其它:失败。参考错误码说明 |
| message | String | 如果 code 不为 0,会有相应的错误信息提示 |
| result | String | 查询结果 |
| data | String | 当前蓝牙版本 |
result 参数列表:
| 参数 | 类型 | 描述 |
|---|---|---|
| url | String | 升级文件下载地址 |
| fileName | String | 文件名 |
| md5 | String | md5 值,用于校验文件完整性 |
| mark | String | 备注信息 |
| sourceVersion | String | 升级前版本号 |
| targetVersion | String | 升级后版本号 |
| updateTime | String | 更新时间 |
存在可升级的蓝牙版本,返回示例:
js
{
"code": 0,
"message": "Success",
"result": {
"url": "http://fota-web.jimicloud.com/api/httpOta/d?url=123/1234/aed7/03A4360B35C0FC5244A6E1B94AE71234",
"fileName": "AL600_RM_GL_V1.6_260114.1806_signed_C5340E6A4EC8854DA77EEF337BC868A2.bin",
"md5": "03A4360B35C0FC5244A6E1B94AE71234",
"mark": "AL600_RM_GL_V1.5_260109.1859 - AL600_RM_GL_V1.6_260114.1806",
"sourceVersion": "AL600_RM_GL_V1.5_260109.1859",
"targetVersion": "AL600_RM_GL_V1.6_260114.1806",
"updateTime": "2026-01-22 06:45:23"
},
"data": "AL600_RM_GL_V1.5_260109.1859"
}不存在可升级的蓝牙版本,返回示例:
js
{
"code": 0,
"message": "success",
"result": null,
"data": "AL600_RM_GL_V1.5_260109.1859"
}