346 lines
8.1 KiB
Markdown
346 lines
8.1 KiB
Markdown
# Sirius 固件 API 接口文档
|
||
|
||
## 基本信息
|
||
|
||
- **Base URL**: `https://api.corewing.com`
|
||
- **接口前缀**: `/sirius_firmware`
|
||
|
||
## 统一响应格式
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "操作成功",
|
||
"data": {},
|
||
"success": true
|
||
}
|
||
```
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| code | Integer | 状态码（200 成功，500 失败） |
|
||
| message | String | 提示消息 |
|
||
| data | Object | 返回数据 |
|
||
| success | Boolean | 是否成功 |
|
||
|
||
## 枚举说明
|
||
|
||
### 固件类型（firmwareType）
|
||
|
||
| 值 | 说明 |
|
||
|----|------|
|
||
| 1 | 高频头 |
|
||
| 2 | 接收机 |
|
||
| 3 | 背包 |
|
||
|
||
### 协议类型（protocolType）
|
||
|
||
| 值 | 说明 |
|
||
|----|------|
|
||
| 1 | ELRS |
|
||
| 2 | CWLink |
|
||
|
||
## 固件对象字段说明
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| id | Integer | 主键ID |
|
||
| firmwareType | Integer | 固件类型：1-高频头，2-接收机，3-背包 |
|
||
| protocolType | Integer | 协议类型：1-ELRS，2-CWLink |
|
||
| versionNumber | String | 版本号，如 v3.0.1 |
|
||
| fileName | String | 文件名 |
|
||
| filePath | String | 文件存储路径 |
|
||
| fileSize | Long | 文件大小（字节） |
|
||
| md5Hash | String | MD5 校验值 |
|
||
| releaseNotes | String | 版本更新说明（可能为 null） |
|
||
| createTime | String | 创建时间 |
|
||
| updateTime | String | 更新时间 |
|
||
|
||
---
|
||
|
||
## 1. 查询最新固件版本
|
||
|
||
**接口描述：** 根据固件类型和协议类型查询最新版本，用于设备端检查更新。
|
||
|
||
**请求方式：** `GET`
|
||
|
||
**请求路径：** `/sirius_firmware/latest`
|
||
|
||
**请求参数：**
|
||
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--------|------|------|------|
|
||
| firmwareType | Integer | 是 | 固件类型：1-高频头，2-接收机，3-背包 |
|
||
| protocolType | Integer | 是 | 协议类型：1-ELRS，2-CWLink |
|
||
|
||
**请求示例：**
|
||
|
||
```bash
|
||
curl -X GET "http://your-server-host:8080/sirius_firmware/latest?firmwareType=1&protocolType=1"
|
||
```
|
||
|
||
**成功响应示例：**
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "操作成功",
|
||
"data": {
|
||
"id": 1,
|
||
"firmwareType": 1,
|
||
"protocolType": 1,
|
||
"versionNumber": "v3.0.1",
|
||
"fileName": "sirius_hf_elrs_v3.0.1.bin",
|
||
"filePath": "https://oss.corewing.com/sirius_firmware/sirius_hf_elrs_v3.0.1.bin",
|
||
"fileSize": 1048576,
|
||
"md5Hash": "d41d8cd98f00b204e9800998ecf8427e",
|
||
"releaseNotes": "优化信号连接稳定性",
|
||
"createTime": "2026-03-10 10:30:00",
|
||
"updateTime": "2026-03-10 10:30:00"
|
||
},
|
||
"success": true
|
||
}
|
||
```
|
||
|
||
**失败响应示例：**
|
||
|
||
```json
|
||
{
|
||
"code": 500,
|
||
"message": "固件不存在",
|
||
"data": null,
|
||
"success": false
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 2. 根据固件类型查询版本列表
|
||
|
||
**接口描述：** 查询指定固件类型下所有版本，按时间倒序排列。
|
||
|
||
**请求方式：** `GET`
|
||
|
||
**请求路径：** `/sirius_firmware/type/{firmwareType}`
|
||
|
||
**路径参数：**
|
||
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--------|------|------|------|
|
||
| firmwareType | Integer | 是 | 固件类型：1-高频头，2-接收机，3-背包 |
|
||
|
||
**请求示例：**
|
||
|
||
```bash
|
||
curl -X GET "http://your-server-host:8080/sirius_firmware/type/1"
|
||
```
|
||
|
||
**成功响应示例：**
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "操作成功",
|
||
"data": [
|
||
{
|
||
"id": 3,
|
||
"firmwareType": 1,
|
||
"protocolType": 2,
|
||
"versionNumber": "v2.1.0",
|
||
"fileName": "sirius_hf_cwlink_v2.1.0.bin",
|
||
"filePath": "https://oss.corewing.com/sirius_firmware/sirius_hf_cwlink_v2.1.0.bin",
|
||
"fileSize": 2097152,
|
||
"md5Hash": "098f6bcd4621d373cade4e832627b4f6",
|
||
"releaseNotes": "新增CWLink协议支持",
|
||
"createTime": "2026-03-12 14:00:00",
|
||
"updateTime": "2026-03-12 14:00:00"
|
||
},
|
||
{
|
||
"id": 1,
|
||
"firmwareType": 1,
|
||
"protocolType": 1,
|
||
"versionNumber": "v3.0.1",
|
||
"fileName": "sirius_hf_elrs_v3.0.1.bin",
|
||
"filePath": "https://oss.corewing.com/sirius_firmware/sirius_hf_elrs_v3.0.1.bin",
|
||
"fileSize": 1048576,
|
||
"md5Hash": "d41d8cd98f00b204e9800998ecf8427e",
|
||
"releaseNotes": "优化信号连接稳定性",
|
||
"createTime": "2026-03-10 10:30:00",
|
||
"updateTime": "2026-03-10 10:30:00"
|
||
}
|
||
],
|
||
"success": true
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 3. 根据固件类型和协议类型查询版本列表
|
||
|
||
**接口描述：** 查询指定固件类型和协议类型下所有版本，按时间倒序排列。
|
||
|
||
**请求方式：** `GET`
|
||
|
||
**请求路径：** `/sirius_firmware/type/{firmwareType}/protocol/{protocolType}`
|
||
|
||
**路径参数：**
|
||
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--------|------|------|------|
|
||
| firmwareType | Integer | 是 | 固件类型：1-高频头，2-接收机，3-背包 |
|
||
| protocolType | Integer | 是 | 协议类型：1-ELRS，2-CWLink |
|
||
|
||
**请求示例：**
|
||
|
||
```bash
|
||
curl -X GET "http://your-server-host:8080/sirius_firmware/type/1/protocol/1"
|
||
```
|
||
|
||
**成功响应示例：**
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "操作成功",
|
||
"data": [
|
||
{
|
||
"id": 5,
|
||
"firmwareType": 1,
|
||
"protocolType": 1,
|
||
"versionNumber": "v3.0.1",
|
||
"fileName": "sirius_hf_elrs_v3.0.1.bin",
|
||
"filePath": "https://oss.corewing.com/sirius_firmware/sirius_hf_elrs_v3.0.1.bin",
|
||
"fileSize": 1048576,
|
||
"md5Hash": "d41d8cd98f00b204e9800998ecf8427e",
|
||
"releaseNotes": "优化信号连接稳定性",
|
||
"createTime": "2026-03-12 14:00:00",
|
||
"updateTime": "2026-03-12 14:00:00"
|
||
},
|
||
{
|
||
"id": 2,
|
||
"firmwareType": 1,
|
||
"protocolType": 1,
|
||
"versionNumber": "v3.0.0",
|
||
"fileName": "sirius_hf_elrs_v3.0.0.bin",
|
||
"filePath": "https://oss.corewing.com/sirius_firmware/sirius_hf_elrs_v3.0.0.bin",
|
||
"fileSize": 1024000,
|
||
"md5Hash": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
|
||
"releaseNotes": null,
|
||
"createTime": "2026-03-01 08:00:00",
|
||
"updateTime": "2026-03-01 08:00:00"
|
||
}
|
||
],
|
||
"success": true
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 4. 查询所有固件
|
||
|
||
**接口描述：** 查询所有固件记录。
|
||
|
||
**请求方式：** `GET`
|
||
|
||
**请求路径：** `/sirius_firmware/list`
|
||
|
||
**请求示例：**
|
||
|
||
```bash
|
||
curl -X GET "http://your-server-host:8080/sirius_firmware/list"
|
||
```
|
||
|
||
**成功响应示例：**
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "操作成功",
|
||
"data": [
|
||
{
|
||
"id": 1,
|
||
"firmwareType": 1,
|
||
"protocolType": 1,
|
||
"versionNumber": "v3.0.1",
|
||
"fileName": "sirius_hf_elrs_v3.0.1.bin",
|
||
"filePath": "https://oss.corewing.com/sirius_firmware/sirius_hf_elrs_v3.0.1.bin",
|
||
"fileSize": 1048576,
|
||
"md5Hash": "d41d8cd98f00b204e9800998ecf8427e",
|
||
"releaseNotes": "优化信号连接稳定性",
|
||
"createTime": "2026-03-10 10:30:00",
|
||
"updateTime": "2026-03-10 10:30:00"
|
||
}
|
||
],
|
||
"success": true
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 5. 根据ID查询固件
|
||
|
||
**接口描述：** 根据固件ID查询详情。
|
||
|
||
**请求方式：** `GET`
|
||
|
||
**请求路径：** `/sirius_firmware/{id}`
|
||
|
||
**路径参数：**
|
||
|
||
| 参数名 | 类型 | 必填 | 说明 |
|
||
|--------|------|------|------|
|
||
| id | Integer | 是 | 固件ID |
|
||
|
||
**请求示例：**
|
||
|
||
```bash
|
||
curl -X GET "http://your-server-host:8080/sirius_firmware/1"
|
||
```
|
||
|
||
**成功响应示例：**
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "操作成功",
|
||
"data": {
|
||
"id": 1,
|
||
"firmwareType": 1,
|
||
"protocolType": 1,
|
||
"versionNumber": "v3.0.1",
|
||
"fileName": "sirius_hf_elrs_v3.0.1.bin",
|
||
"filePath": "https://oss.corewing.com/sirius_firmware/sirius_hf_elrs_v3.0.1.bin",
|
||
"fileSize": 1048576,
|
||
"md5Hash": "d41d8cd98f00b204e9800998ecf8427e",
|
||
"releaseNotes": "优化信号连接稳定性",
|
||
"createTime": "2026-03-10 10:30:00",
|
||
"updateTime": "2026-03-10 10:30:00"
|
||
},
|
||
"success": true
|
||
}
|
||
```
|
||
|
||
**失败响应示例：**
|
||
|
||
```json
|
||
{
|
||
"code": 500,
|
||
"message": "固件不存在",
|
||
"data": null,
|
||
"success": false
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 接口总览
|
||
|
||
| 方法 | 路径 | 说明 | 使用场景 |
|
||
|------|------|------|----------|
|
||
| GET | `/sirius_firmware/latest?firmwareType=&protocolType=` | 查询最新版本 | 设备端检查更新 |
|
||
| GET | `/sirius_firmware/type/{firmwareType}` | 按固件类型查版本列表 | 查看某类固件所有版本 |
|
||
| GET | `/sirius_firmware/type/{firmwareType}/protocol/{protocolType}` | 按类型+协议查版本列表 | 精确筛选版本列表 |
|
||
| GET | `/sirius_firmware/list` | 查询所有固件 | 管理端展示全部数据 |
|
||
| GET | `/sirius_firmware/{id}` | 按ID查询固件 | 查看固件详情 |
|
||
|
||
--- |