API文档
生成Token
POST /tokens请求参数(Body)
| 字段 | 类型 | 说明 |
|---|---|---|
| String | 邮箱 | |
| *password | String | 密码 |
返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| status | Boolean | 状态，true 或 false |
| message | String | 描述信息 |
| data | Object | 数据 |
| token | String | Token |
清空 Token
DELETE /tokens返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| status | Boolean | 状态，true 或 false |
| message | String | 描述信息 |
| data | Object | 数据 |
用户资料
GET /profile返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| status | Boolean | 状态，true 或 false |
| message | String | 描述信息 |
| data | Object | 数据 |
| name | String | 用户名 |
| avatar | String | 头像地址 |
| String | 邮箱地址 | |
| capacity | Float | 总容量 |
| used_capacity | Float | 已使用容量 |
| url | String | 个人主页地址 |
| image_num | Integer | 图片数量 |
| album_num | Integer | 相册数量 |
| registered_ip | String | 注册 IP |
策略相关
策略列表
GET /strategies请求参数(Query)
| 字段 | 类型 | 说明 |
|---|---|---|
| keyword | String | 筛选关键字 |
返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| status | Boolean | 状态，true 或 false |
| message | String | 描述信息 |
| data | Object | 数据 |
| strategies | Object[] | 策略数据 |
| id | Integer | 策略 ID |
| name | String | 策略名称 |
图片相关
上传图片
POST /uploadHeaders
| 字段 | 类型 | 说明 |
|---|---|---|
| *Content-Type | String | 需要设置为 multipart/form-data |
请求参数(Body)
| 字段 | 类型 | 说明 |
|---|---|---|
| *file | File | 图片文件 |
| strategy_id | Integer | 储存策略ID |
返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| status | Boolean | 状态，true 或 false |
| message | String | 描述信息 |
| data | Object | 数据 |
| key | String | 图片唯一密钥 |
| name | String | 图片名称 |
| pathname | String | 图片路径名 |
| origin_name | String | 图片原始名 |
| size | Float | 图片大小，单位 KB |
| mimetype | String | 图片类型 |
| extension | String | 图片拓展名 |
| md5 | String | 图片 md5 值 |
| sha1 | String | 图片 sha1 值 |
| links | Object | 链接 |
| url | String | 图片访问 url |
| html | String | - |
| bbcode | String | - |
| markdown | String | - |
| markdown_with_link | String | - |
| thumbnail_url | String | 缩略图 url |
图片列表
GET /images请求参数(Query)
| 字段 | 类型 | 说明 |
|---|---|---|
| page | Integer | 页码 |
| order | String | 排序方式，newest=最新，earliest=最早，utmost=最大，least=最小 |
| permission | String | 权限，public=公开的，private=私有的 |
| album_id | Integer | 相册 ID |
| keyword | String | 筛选关键字 |
返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| status | Boolean | 状态，true 或 false |
| message | String | 描述信息 |
| data | Object | 数据 |
| current_page | Integer | 当前所在页页码 |
| last_page | Integer | 最后一页页码 |
| per_page | Integer | 每页展示数据数量 |
| total | Integer | 图片总数量 |
| data | Object[] | 图片列表 |
| key | String | 图片唯一密钥 |
| name | String | 图片名称 |
| origin_name | String | 图片原始名称 |
| pathname | String | 图片路径名 |
| size | Float | 图片大小，单位 KB |
| width | Integer | 图片宽度 |
| height | nteger | 图片高度 |
| md5 | String | 图片 md5 值 |
| sha1 | String | 图片 sha1 值 |
| human_date | String | 上传时间(友好格式) |
| date | String | 上传日期(yyyy-MM-dd HH:mm:ss) |
| links | Object | 链接，与上传接口返回参数中的 links 相同 |
删除图片
DELETE /images/:key请求参数(Params)
| 字段 | 类型 | 说明 |
|---|---|---|
| *key | String | 图片密钥 |
返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| status | Boolean | 状态，true 或 false |
| message | String | 描述信息 |
| data | Object | 数据 |
相册相关
相册列表
GET /albums请求参数(Query)
| 字段 | 类型 | 说明 |
|---|---|---|
| page | Integer | 页码 |
| order | String | 排序方式，newest=最新，earliest=最早，most=图片 |
| keyword | String | 筛选关键字 |
返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| status | Boolean | 状态，true 或 false |
| message | String | 描述信息 |
| data | Object | 数据 |
| current_page | Integer | 当前所在页页码 |
| last_page | Integer | 最后一页页码 |
| per_page | Integer | 每页展示数据数量 |
| total | Integer | 图片总数量 |
| data | Object[] | 相册列表 |
| id | Integer | 相册自增 ID |
| name | String | 相册名称 |
| intro | String | 相册简介 |
| image_num | Integer | 相册图片数量 |
删除相册
DELETE /albums/:id请求参数(Params)
| 字段 | 类型 | 说明 |
|---|---|---|
| *id | String | 相册自增 ID |
返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| status | Boolean | 状态，true 或 false |
| message | String | 描述信息 |
| data | Object | 数据 |
修改于 2025-10-11 15:49:23