mirror of
https://github.com/whitechi73/OpenShamrock.git
synced 2024-08-14 13:12:17 +08:00
修正接口文件相关说明，修改支持的QQ版本说明
This commit is contained in:
owo233
parent
cbb8f194a8
commit
8df6e20768
189
docs/api/file.md
189
docs/api/file.md
@ -9,56 +9,62 @@ icon: file
|
|||||||
|
|
||||||
## 上传私聊文件
|
## 上传私聊文件
|
||||||
|
|
||||||
该接口用于上传群文件。
|
该接口用于上传私聊文件。
|
||||||
|
|
||||||
终结点: `/upload_private_file`
|
::: warning 注意
|
||||||
|
只能上传本地文件, 需要上传 `http` 文件的话请先下载至本地
|
||||||
|
:::
|
||||||
|
|
||||||
|
### API 端点
|
||||||
|
|
||||||
|
`/upload_private_file`
|
||||||
|
|
||||||
### 参数
|
### 参数
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
| 字段 | 类型 | 说明 |
|
||||||
| -------- | ------ | ------------ |
|
|---------|--------|--------|
|
||||||
| user_id | int64 | 目标 |
|
| user_id | int64 | 目标 |
|
||||||
| file | string | 本地文件路径 |
|
| file | string | 本地文件路径 |
|
||||||
| name | string | 储存名称 |
|
| name | string | 文件名称 |
|
||||||
|
|
||||||
## 上传群文件
|
## 上传群文件
|
||||||
|
|
||||||
该接口用于上传群文件。
|
该接口用于上传群文件。
|
||||||
|
|
||||||
终结点: `/upload_group_file`
|
::: warning 注意
|
||||||
|
只能上传本地文件, 需要上传 `http` 文件的话请先下载至本地
|
||||||
|
:::
|
||||||
|
|
||||||
|
### API 端点
|
||||||
|
|
||||||
|
`/upload_group_file`
|
||||||
|
|
||||||
### 参数
|
### 参数
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
| 字段 | 类型 | 说明 |
|
||||||
| -------- | ------ | ------------ |
|
|----------|--------|--------|
|
||||||
| group_id | int64 | 群号 |
|
| group_id | int64 | 群号 |
|
||||||
| file | string | 本地文件路径 |
|
| file | string | 本地文件路径 |
|
||||||
| name | string | 储存名称 |
|
| name | string | 文件名称 |
|
||||||
|
|
||||||
::: warning 注意
|
::: warning 注意
|
||||||
参数 `folder`在Shamrock不受支持。
|
参数 `folder`在Shamrock不受支持。
|
||||||
:::
|
:::
|
||||||
|
|
||||||
### 参数
|
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
|
||||||
| -------- | ------ | ------------ |
|
|
||||||
| group_id | int64 | 群号 |
|
|
||||||
| file | string | 本地文件路径 |
|
|
||||||
| name | string | 储存名称 |
|
|
||||||
|
|
||||||
## 删除群文件
|
## 删除群文件
|
||||||
|
|
||||||
该接口用于删除群文件。
|
该接口用于删除群文件。
|
||||||
|
|
||||||
终结点: `/delete_group_file`
|
### API 端点
|
||||||
|
|
||||||
|
`/delete_group_file`
|
||||||
|
|
||||||
### 参数
|
### 参数
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
| 字段 | 类型 | 说明 |
|
||||||
| -------- | ------ | -------------------------------- |
|
|----------|--------|--------------------------|
|
||||||
| group_id | int64 | 群号 |
|
| group_id | int64 | 群号 |
|
||||||
| file_id | string | 文件ID 参考 [File](#file) 对象 |
|
| file_id | string | 文件ID 参考 [File](#file) 对象 |
|
||||||
| busid | int32 | 文件类型 参考 [File](#file) 对象 |
|
| busid | int32 | 文件类型 参考 [File](#file) 对象 |
|
||||||
|
|
||||||
::: tip 提示
|
::: tip 提示
|
||||||
@ -66,19 +72,22 @@ icon: file
|
|||||||
:::
|
:::
|
||||||
|
|
||||||
## 创建群文件文件夹
|
## 创建群文件文件夹
|
||||||
|
|
||||||
该接口用于创建群文件文件夹。
|
该接口用于创建群文件文件夹。
|
||||||
|
|
||||||
::: warning 注意
|
::: warning 注意
|
||||||
仅能在根目录创建文件夹
|
仅能在根目录创建文件夹
|
||||||
:::
|
:::
|
||||||
|
|
||||||
终结点: `/create_group_file_folder`
|
### API 端点
|
||||||
|
|
||||||
|
`/create_group_file_folder`
|
||||||
|
|
||||||
### 响应
|
### 响应
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
| 字段 | 类型 | 说明 |
|
||||||
| --------- | ------ | ---------- |
|
|--------|-------|--------|
|
||||||
| msg_id | int32 | 文件消息id |
|
| msg_id | int32 | 文件消息id |
|
||||||
|
|
||||||
::: tip 提示
|
::: tip 提示
|
||||||
该 API 无响应数据
|
该 API 无响应数据
|
||||||
@ -88,11 +97,13 @@ icon: file
|
|||||||
|
|
||||||
该接口用于删除群文件文件夹。
|
该接口用于删除群文件文件夹。
|
||||||
|
|
||||||
终结点: `/delete_group_folder`
|
### API 端点
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
`/delete_group_folder`
|
||||||
| --------- | ------ | ------------------------------------ |
|
|
||||||
| group_id | int64 | 群号 |
|
| 字段 | 类型 | 说明 |
|
||||||
|
|-----------|--------|-------------------------------|
|
||||||
|
| group_id | int64 | 群号 |
|
||||||
| folder_id | string | 文件夹ID 参考 [Folder](#folder) 对象 |
|
| folder_id | string | 文件夹ID 参考 [Folder](#folder) 对象 |
|
||||||
|
|
||||||
::: tip 提示
|
::: tip 提示
|
||||||
@ -103,22 +114,24 @@ icon: file
|
|||||||
|
|
||||||
该接口用于获取群文件系统信息。
|
该接口用于获取群文件系统信息。
|
||||||
|
|
||||||
终结点: `/get_group_file_system_info`
|
### API 端点
|
||||||
|
|
||||||
|
`/get_group_file_system_info`
|
||||||
|
|
||||||
### 参数
|
### 参数
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
| 字段 | 类型 | 说明 |
|
||||||
| -------- | ----- | ---- |
|
|----------|-------|----|
|
||||||
| group_id | int64 | 群号 |
|
| group_id | int64 | 群号 |
|
||||||
|
|
||||||
### 响应
|
### 响应
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
| 字段 | 类型 | 说明 |
|
||||||
| ----------- | ----- | ---------- |
|
|-------------|-------|-------|
|
||||||
| file_count | int32 | 文件总数 |
|
| file_count | int32 | 文件总数 |
|
||||||
| limit_count | int32 | 文件上限 |
|
| limit_count | int32 | 文件上限 |
|
||||||
| used_space | int64 | 已使用空间 |
|
| used_space | int64 | 已使用空间 |
|
||||||
| total_space | int64 | 空间上限 |
|
| total_space | int64 | 空间上限 |
|
||||||
|
|
||||||
## 获取群根目录文件列表
|
## 获取群根目录文件列表
|
||||||
|
|
||||||
@ -130,42 +143,42 @@ icon: file
|
|||||||
|
|
||||||
### 参数
|
### 参数
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
| 字段 | 类型 | 说明 |
|
||||||
| -------- | ----- | ---- |
|
|----------|-------|----|
|
||||||
| group_id | int64 | 群号 |
|
| group_id | int64 | 群号 |
|
||||||
|
|
||||||
### 响应
|
### 响应
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
| 字段 | 类型 | 说明 |
|
||||||
| ------- | ----------------------- | ---------- |
|
|---------|-------------------------|-------|
|
||||||
| files | List<[File](#file)> | 文件列表 |
|
| files | List<[File](#file)> | 文件列表 |
|
||||||
| folders | List<[Folder](#folder)> | 文件夹列表 |
|
| folders | List<[Folder](#folder)> | 文件夹列表 |
|
||||||
|
|
||||||
#### File
|
#### File
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
| 字段 | 类型 | 说明 |
|
||||||
| -------------- | ------ | ----------------------- |
|
|----------------|--------|--------------|
|
||||||
| group_id | int32 | 群号 |
|
| group_id | int32 | 群号 |
|
||||||
| file_id | string | 文件ID |
|
| file_id | string | 文件ID |
|
||||||
| file_name | string | 文件名 |
|
| file_name | string | 文件名 |
|
||||||
| busid | int32 | 文件类型 |
|
| busid | int32 | 文件类型 |
|
||||||
| file_size | int64 | 文件大小 |
|
| file_size | int64 | 文件大小 |
|
||||||
| upload_time | int64 | 上传时间 |
|
| upload_time | int64 | 上传时间 |
|
||||||
| dead_time | int64 | 过期时间，永久文件恒为0 |
|
| dead_time | int64 | 过期时间，永久文件恒为0 |
|
||||||
| modify_time | int64 | 最后修改时间 |
|
| modify_time | int64 | 最后修改时间 |
|
||||||
| download_times | int32 | 下载次数 |
|
| download_times | int32 | 下载次数 |
|
||||||
| uploader | int64 | 上传者ID |
|
| uploader | int64 | 上传者ID |
|
||||||
| uploader_name | string | 上传者名字 |
|
| uploader_name | string | 上传者名字 |
|
||||||
|
|
||||||
#### Folder
|
#### Folder
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
| 字段 | 类型 | 说明 |
|
||||||
| ---------------- | ------ | ---------- |
|
|------------------|--------|-------|
|
||||||
| group_id | int32 | 群号 |
|
| group_id | int32 | 群号 |
|
||||||
| folder_id | string | 文件夹ID |
|
| folder_id | string | 文件夹ID |
|
||||||
| folder_name | string | 文件名 |
|
| folder_name | string | 文件名 |
|
||||||
| create_time | int64 | 创建时间 |
|
| create_time | int64 | 创建时间 |
|
||||||
| creator | int64 | 创建者 |
|
| creator | int64 | 创建者 |
|
||||||
| creator_name | string | 创建者名字 |
|
| creator_name | string | 创建者名字 |
|
||||||
| total_file_count | int32 | 子文件数量 |
|
| total_file_count | int32 | 子文件数量 |
|
||||||
|
|
||||||
@ -179,16 +192,16 @@ icon: file
|
|||||||
|
|
||||||
### 参数
|
### 参数
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
| 字段 | 类型 | 说明 |
|
||||||
| --------- | ------ | ------------------------------------ |
|
|-----------|--------|-------------------------------|
|
||||||
| group_id | int64 | 群号 |
|
| group_id | int64 | 群号 |
|
||||||
| folder_id | string | 文件夹ID 参考 [Folder](#folder) 对象 |
|
| folder_id | string | 文件夹ID 参考 [Folder](#folder) 对象 |
|
||||||
|
|
||||||
### 响应
|
### 响应
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
| 字段 | 类型 | 说明 |
|
||||||
| ------- | -------- | ---------- |
|
|---------|----------|-------|
|
||||||
| files | File[] | 文件列表 |
|
| files | File[] | 文件列表 |
|
||||||
| folders | Folder[] | 文件夹列表 |
|
| folders | Folder[] | 文件夹列表 |
|
||||||
|
|
||||||
## 获取群文件资源链接
|
## 获取群文件资源链接
|
||||||
@ -201,34 +214,14 @@ icon: file
|
|||||||
|
|
||||||
### 参数
|
### 参数
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
| 字段 | 类型 | 说明 |
|
||||||
| -------- | ------ | -------------------------------- |
|
|----------|--------|--------------------------|
|
||||||
| group_id | int64 | 群号 |
|
| group_id | int64 | 群号 |
|
||||||
| file_id | string | 文件ID 参考 [File](#file) 对象 |
|
| file_id | string | 文件ID 参考 [File](#file) 对象 |
|
||||||
| busid | int32 | 文件类型 参考 [File](#file) 对象 |
|
| busid | int32 | 文件类型 参考 [File](#file) 对象 |
|
||||||
|
|
||||||
### 响应
|
### 响应
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
| 字段 | 类型 | 说明 |
|
||||||
| ---- | ------ | ------------ |
|
|-----|--------|--------|
|
||||||
| url | string | 文件下载链接 |
|
| url | string | 文件下载链接 |
|
||||||
|
|
||||||
## 上传私聊文件 <Badge text="未实现" type="danger" />
|
|
||||||
|
|
||||||
该接口用于上传私聊文件。
|
|
||||||
|
|
||||||
### API 端点
|
|
||||||
|
|
||||||
`/upload_private_file`
|
|
||||||
|
|
||||||
### 参数
|
|
||||||
|
|
||||||
| 字段 | 类型 | 说明 |
|
|
||||||
| ------- | ------ | ------------ |
|
|
||||||
| user_id | int64 | 对方 QQ 号 |
|
|
||||||
| file | string | 本地文件路径 |
|
|
||||||
| name | string | 文件名称 |
|
|
||||||
|
|
||||||
::: warning 注意
|
|
||||||
只能上传本地文件, 需要上传 `http` 文件的话请先下载至本地
|
|
||||||
:::
|
|
||||||
|
|||||||
@ -6,7 +6,7 @@ icon: question-circle
|
|||||||
### 支持的QQ版本
|
### 支持的QQ版本
|
||||||
|
|
||||||
- 版本 `8.9.68`，`8.9.70`，`8.9.73`，`8.9.75`，`8.9.78`，`8.9.80`，`8.9.81`，`8.9.83`
|
- 版本 `8.9.68`，`8.9.70`，`8.9.73`，`8.9.75`，`8.9.78`，`8.9.80`，`8.9.81`，`8.9.83`
|
||||||
- 未在上述说明中列出的版本可能存在兼容问题。
|
- 理论上支持上述说明未提到的更高版本，如遇问题请提交issue
|
||||||
|
|
||||||
### 反检测
|
### 反检测
|
||||||
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user