OTA接口

本文档介绍巴法云OTA（Over-The-Air）固件升级相关的API接口。

获取OTA固件链接

• 请求地址：https://apis.bemfa.com/vb/api/v1/firmwareVersion

参数	是否必须	类型	说明
openID	是	字符串类型	用户私钥
topic	是	字符串	主题值
deviceType	是	整型	1=MQTT设备，3=TCP设备，5=MQTT设备v2，7=TCP设备v2，
secure	否	布尔	如果是true,则返回https的url

示例：https://apis.bemfa.com/vb/api/v1/firmwareVersion?openID=4d9ec352e0376f2110a0c601a2857225&topic=AM8kJZZgX002&deviceType=3

正确返回：

{
  "code": 0,
  "msg": "success",
  "data": {
    "url": "http://bin.bemfa.com/b/28687/3BcNGQ5ZWMzNTJlMDM3NmYyMTEwYTBjNjAxYTI4NTcyMjU=AM8kJZZgX002.bin",
    "version": 2,
    "tag": "固件备注",
    "size": 7918,
    "unix": 1773584364
  }
}

参数说明

参数	类型	说明
url	字符串	固件地址
version	整形	固件版本
tag	字符串	固件备注
size	整形	固件大小
unix	整形	时间戳

OTA固件上传

支持的格式：bin类型，py类型。

form-data格式

接口信息

• 请求方法：POST
• 请求地址：https://apis.bemfa.com/vb/api/v1/binUpload
• Content-Type：multipart/form-data

请求参数

参数	是否必须	类型	说明
openID	是	字符串类型	用户私钥
topic	是	字符串类型	主题值，需要先在控制台创建
deviceType	是	整数类型	1 mqtt设备，3tcp设备
bin	是	file文件类型	固件文件
tag	否	字符串类型	标记或备注

正确返回：

{
    "code": 0,
    "msg": "success",
    "data": {
        "url": "http://bin.bemfa.com/b/3Bc4674-1739773777ZXQuEhdqR0iT=EF7B92001.bin",
        "time": "2025-02-17 14:35:29",
        "size": 369808
    }
}

参数	类型	说明
size	整形	固件大小
time	字符串	上传时间
url	字符串	固件地址

请求示例：