返回参数说明:
| 参数 | 类型 | 说明 |
|---|
| success | boolean | 请求是否成功 |
| id | integer | 创建的分类id |
获取所有分类
接口地址: /categories
请求方法: GET
返回示例:
{
"success": true,
"data": [
{
"id": 1,
"name": "Sports",
"desc": "Sports firmware"
},
{
"id": 2,
"name": "Outdoor",
"desc": "Outdoor firmware"
}
]
}
返回参数说明:
| 参数 | 类型 | 说明 |
|---|
| success | boolean | 请求是否成功 |
| data | array | 分类列表 |
| id | integer | 分类id |
| name | string | 分类名称 |
| desc | string | 分类描述 |
创建固件
接口地址: /admin/add_firmware
请求方法: POST
请求体:
{
"name": "string",
"version": "string",
"model": "string",
"desc": "string",
"file_id": "string",
"md5": "string",
"cid": "string",
"size": "string",
"download_url": "string"
}
返回示例:
{
"success": true,
"id": 1
}
返回参数说明:
| 参数 | 类型 | 说明 |
|---|
| success | boolean | 请求是否成功 |
| id | integer | 创建的固件id |
获取固件列表
接口地址: /firmwares
请求方法: GET
请求参数:
返回示例:
{
"success": true,
"data": {
"total": 10,
"page": 1,
"per_page": 10,
"data": [
{
"id": 1,
"name": "Firmware 1",
"version": "1.0",
"model": "Model A",
...
},
{
"id": 2,
"name": "Firmware 2",
"version": "1.1",
"model": "Model B",
...
}
]
}
}
返回参数说明:
| 参数 | 类型 | 说明 |
|---|
| success | boolean | 请求是否成功 |
| data | object | 固件列表数据 |
| total | integer | 总数 |
| page | integer | 当前页码 |
| per_page | integer | 每页数量 |
| data | array | 固件列表 |
搜索固件
接口地址: /search
请求方法: GET
请求参数:
| 参数 | 类型 | 说明 |
|---|
| query | string | 搜索关键词 |
| page | integer | 页码 |
返回示例:
{
"success": true,
"data": {
"total": 1,
"page": 1,
"per_page": 10,
"data": [
{
"id": 1,
"name": "Firmware 1",
"version": "1.0",
"model": "Model A",
...
}
]
}
}
返回参数说明:
| 参数 | 类型 | 说明 |
|---|
| success | boolean | 请求是否成功 |
| data | object | 固件列表数据 |
| total | integer | 总数 |
| page | integer | 当前页码 |
| per_page | integer | 每页数量 |
| data | array | 固件列表 |
获取分类下的固件
接口地址: /categories/{category_id}/firmwares
请求方法: GET
路径参数:
| 参数 | 类型 | 说明 |
|---|
| category_id | integer | 分类id |
请求参数:
返回示例:
{
"success": true,
"data": {
"total": 2,
"page": 1,
"per_page": 10,
"data": [
{
"id": 1,
"name": "Firmware 1",
"version": "1.0",
"model": "Model A",
...
},
{
"id": 2,
"name": "Firmware 2",
"version": "1.1",
"model": "Model B",
...
}
]
}
}
返回参数说明:
| 参数 | 类型 | 说明 |
|---|
| success | boolean | 请求是否成功 |
| data | object | 固件列表数据 |
| total | integer | 总数 |
| page | integer | 当前页码 |
| per_page | integer | 每页数量 |
| data | array | 固件列表 |
给分类添加固件
接口地址: /admin/categories/{category_id}/add
请求方法: POST
路径参数:
| 参数 | 类型 | 说明 |
|---|
| category_id | integer | 分类id |
请求体:
{
"firmware_id": "integer"
}
返回示例:
{
"success": true,
"message": "Firmware added to category."
}
返回参数说明:
| 参数 | 类型 | 说明 |
|---|
| success | boolean | 请求是否成功 |
| message | string | 操作结果信息 |
获取固件所属分类
接口地址: /firmwares/{firmware_id}/categories
请求方法: GET
路径参数:
| 参数 | 类型 | 说明 |
|---|
| firmware_id | integer | 固件id |
返回示例:
{
"success": true,
"data": {
"categories": [1, 2]
}
}
返回参数说明:
| 参数 | 类型 | 说明 |
|---|
| success | boolean | 请求是否成功 |
| data | object | 结果数据 |
| categories | array | 分类id数组 |
创建下载日志
接口地址: /logs
请求方法: POST
请求体:
{
"firmware_id": "integer",
"ip": "string"
}
返回示例:
{
"success": true,
"message": "Download log saved."
}
返回参数说明:
| 参数 | 类型 | 说明 |
|---|
| success | boolean | 请求是否成功 |
| message | string | 操作结果信息 |
获取下载日志
接口地址: /admin/logs
请求方法: GET
请求参数:
返回示例:
{
"total": 100,
"page": 1,
"per_page": 10,
"logs": [
{
"id": 1,
"firmware_id": 1,
"ip": "127.0.0.1",
"timestamp": "2023-02-15T08:25:33"
},
{
"id": 2,
"firmware_id": 2,
"ip": "127.0.0.2",
"timestamp": "2023-02-15T09:12:54"
}
]
}
返回参数说明:
| 参数 | 类型 | 说明 |
|---|
| total | integer | 总数 |
| page | integer | 当前页码 |
| per_page | integer | 每页数量 |
| logs | array | 日志列表 |
| id | integer | 日志id |
| firmware_id | integer | 固件id |
| ip | string | IP地址 |
| timestamp | datetime | 时间戳 |
获取固件详情
接口地址: /firmwares/{firmware_id}
请求方法: GET
路径参数:
| 参数 | 类型 | 说明 |
|---|
| firmware_id | integer | 固件id |
返回示例:
{
"success": true,
"data": {
"id": 1,
"name": "Firmware 1",
"version": "1.0",
"model": "Model A",
...
}
}
返回参数说明:
| 参数 | 类型 | 说明 |
|---|
| success | boolean | 请求是否成功 |
| data | object | 固件信息 |