diff --git a/docs/api/file.md b/docs/api/file.md index 6000340..445c4c0 100644 --- a/docs/api/file.md +++ b/docs/api/file.md @@ -150,15 +150,50 @@ icon: file `/create_group_file_folder` -### 响应 +### 参数 -| 字段 | 类型 | 说明 | -|--------|-------|--------| -| msg_id | int32 | 文件消息id | +| 字段 | 类型 | 说明 | +|-----------|--------|-------------------------------| +| group_id | int64 | 群号 | +| name | string | 群文件夹名字 | -::: tip 提示 -该 API 无响应数据 -::: +### 响应示例 + +```json +{ + "status": "ok", + "retcode": 0, + "data": { + "folder_id": "/ad86c100-031d-4139-8cab-c6c661a413ba", + "parent_folder_id": "/", + "folder_name": "测试", + "create_time": 1706269735, + "modify_time": 1706269735, + "creator_uin": 1650114384, + "modifier_uin": 1650114384 + }, + "message": "成功", + "echo": 111 +} +``` + +## 重命名群文件夹 + +把已经存在的群文件夹改个名字。 + +### API 端点 + +`/rename_group_folder` + +| 字段 | 类型 | 说明 | +|-----------|--------|-------------------------------| +| group_id | int64 | 群号 | +| folder_id | string | 群文件夹ID | +| name | string | 群文件夹名字 | + +### 响应解释 + +可通过返回的状态码判断重命名是否成功。 ## 删除群文件文件夹 @@ -168,14 +203,16 @@ icon: file `/delete_group_folder` +### 参数 + | 字段 | 类型 | 说明 | |-----------|--------|-------------------------------| | group_id | int64 | 群号 | | folder_id | string | 文件夹ID 参考 [Folder](#folder) 对象 | -::: tip 提示 -该 API 无响应数据 -::: +### 响应解释 + +可通过返回的状态码判断删除是否成功。 ## 获取群文件系统信息