简介

获取OTA固件

获取固件

GET接口

https://api.bemfa.com/api/device/v1/bin/

参数	是否必须	说明
uid	是	用户私钥
topic	是	主题名称，仅限字母、数字类型
type	是	类型类型，type=1是MQTT设备云，3是tcp设备云

返回示例

{
    "code": 5723007,
    "data": {
        "url": "http://bin.bemfa.com/b/3BcNzgwMWU0YmExYmY3NDA2NTkzZDQ3MjUwNzk3ODYwZmQ=1001.bin",
        "time": "2025-02-11 17:30:51",
        "v": 5,
        "tag": "",
        "size": 31140
    }
}

参数	类型	说明
code	整形	状态码
url	字符串	固件地址
v	整形	版本
tag	字符串	标记
size	整形	固件大小，单位字节

code状态码

状态码	说明
5723001	缺少uid字段
5723002	uid值为空或不正确
5723003	缺少type字段
5723004	type值为空或不正确
5723005	缺少topic字段
5723007	获取成功
5724009	固件为空不存在

OTA固件上传

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

form-data格式

POST接口

https://apis.bemfa.com/vb/api/v1/binUpload

body参数

参数	是否必须	类型	说明
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	字符串	固件地址

请求示例：