文件 API
upload_private_file 上传私聊文件
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| user_id | int64 | 好友 QQ 号 |
| file_uri | string | 文件 URI，支持 `file://` `http(s)://` `base64://` 三种格式 |
| file_name | string | 文件名称 |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| file_id | string | 文件 ID |
upload_group_file 上传群文件
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| parent_folder_id | string (default: "/") | 目标文件夹 ID |
| file_uri | string | 文件 URI，支持 `file://` `http(s)://` `base64://` 三种格式 |
| file_name | string | 文件名称 |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| file_id | string | 文件 ID |
get_private_file_download_url 获取私聊文件下载链接
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| user_id | int64 | 好友 QQ 号 |
| file_id | string | 文件 ID |
| file_hash | string | 文件的 TriSHA1 哈希值 |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| download_url | string | 文件下载链接 |
get_group_file_download_url 获取群文件下载链接
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| file_id | string | 文件 ID |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| download_url | string | 文件下载链接 |
get_group_files 获取群文件列表
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| parent_folder_id | string (default: "/") | 父文件夹 ID |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| files | GroupFileEntity[] | 文件列表 |
| folders | GroupFolderEntity[] | 文件夹列表 |
move_group_file 移动群文件
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| file_id | string | 文件 ID |
| parent_folder_id | string (default: "/") | 文件所在的文件夹 ID |
| target_folder_id | string (default: "/") | 目标文件夹 ID |
输出参数
此 API 无输出参数，请协议端传入 {}。
rename_group_file 重命名群文件
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| file_id | string | 文件 ID |
| parent_folder_id | string (default: "/") | 文件所在的文件夹 ID |
| new_file_name | string | 新文件名称 |
输出参数
此 API 无输出参数，请协议端传入 {}。
delete_group_file 删除群文件
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| file_id | string | 文件 ID |
输出参数
此 API 无输出参数，请协议端传入 {}。
create_group_folder 创建群文件夹
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| folder_name | string | 文件夹名称 |
输出参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| folder_id | string | 文件夹 ID |
rename_group_folder 重命名群文件夹
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| folder_id | string | 文件夹 ID |
| new_folder_name | string | 新文件夹名 |
输出参数
此 API 无输出参数，请协议端传入 {}。
delete_group_folder 删除群文件夹
输入参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| group_id | int64 | 群号 |
| folder_id | string | 文件夹 ID |
输出参数
此 API 无输出参数，请协议端传入 {}。