Add Feature:增加随机图API

This commit is contained in:
MarSeventh
2024-07-25 10:49:56 +08:00
parent 439551695a
commit 8bbe081dc5
3 changed files with 60 additions and 3 deletions

View File

@@ -33,6 +33,9 @@
- **支持身份认证、防滥用**
- 支持Web和API上传认证感谢[hl128k](https://github.com/hl128k)
- 支持访问域名限制(感谢[hl128k](https://github.com/hl128k)
- **一些小功能**
- 支持随机图API从图床中随机返回一张图片
## 3.Deployment
@@ -84,6 +87,7 @@ API格式
| 接口名称 | /upload |
| ------------ | ------------------------------------------------------------ |
| **接口功能** | 上传图片或视频 |
| **请求方法** | POST |
| **请求参数** | **Query参数**<br />`authCode`string类型即为你设置的认证码<br />**Body参数(application/form-data)**<br />`file`file类型你要上传的文件 |
| **返回响应** | `data[0].src`为获得的图片链接(注意不包含域名,需要自己添加) |
@@ -115,6 +119,31 @@ API格式
便于开发者进行bug的捕捉和定位但是**过程中可能收集到访问链接、域名等信息**,如您不愿意泄露类似信息给项目开发者,可在环境变量中添加`disable_telemetry``true`来退出遥测。
#### 随机图API
| 接口名称 | /random |
| ------------ | ---------------------------------------------------- |
| **接口功能** | 从图床中随机返回一张图片的链接(注意会消耗列出次数) |
| **前置条件** | 设置`AllowRandom`环境变量,值为`true` |
| **请求方法** | GET |
| **请求参数** | 无 |
| **响应格式** | data.url为返回的链接。 |
> **请求示例**
>
> ```bash
> curl --location --request GET 'https://your.domain/random' \
> --header 'User-Agent: Apifox/1.0.0 (https://apifox.com)'
> ```
>
> **响应示例**
>
> ```json
> {
> "url": "/file/4fab4d423d039b4665a27.jpg"
> }
> ```
#### 注意
**修改环境变量后需要重新部署才能生效!**
@@ -125,9 +154,17 @@ API格式
## 4.TODO
### 4.1Add Features💕
1. ~~增加粘贴图片上传功能2024.7.22已完成)~~
2. ~~增加markdown、html等格式链接复制功能2024.7.21已完成)~~
3. ~~上传页面增加管理端入口2024.7.21已完成)~~
4. 增加用户个性化配置接口
5. ~~增加随机图API2024.7.25已完成)~~
### 4.2Fix Bugs👻
1. ~~修复API上传无法直接展示在后台的问题2024.7.25已修复)~~
## 5.Tips