416 lines
14 KiB
Markdown
416 lines
14 KiB
Markdown
# 会议管理接口文档
|
||
|
||
## 接口列表
|
||
|
||
### 1. 创建会议
|
||
|
||
**接口地址：** `POST /meeting/create_meeting`
|
||
|
||
**请求参数：**
|
||
|
||
```json
|
||
{
|
||
"meetingID": "string", // 会议ID（选填，不填则自动生成）
|
||
"subject": "string", // 会议主题（必填）
|
||
"coverURL": "string", // 封面URL（选填）
|
||
"scheduledTime": 1234567890000, // 预约时间戳（毫秒，必填）
|
||
"description": "string", // 会议描述（选填）
|
||
"duration": 60, // 会议时长（分钟，选填）
|
||
"estimatedCount": 100, // 会议预估人数（选填）
|
||
"enableMic": true, // 是否开启连麦（选填，默认false）
|
||
"enableComment": true, // 是否开启评论（选填，默认false）
|
||
"anchorUserIDs": ["user1", "user2"], // 主播用户ID列表（多选，选填）
|
||
"ex": "string" // 扩展字段（选填）
|
||
}
|
||
```
|
||
|
||
**响应参数：**
|
||
|
||
```json
|
||
{
|
||
"errCode": 0,
|
||
"errMsg": "",
|
||
"errDlt": "",
|
||
"data": {
|
||
"meetingInfo": {
|
||
"meetingID": "string", // 会议ID
|
||
"subject": "string", // 会议主题
|
||
"coverURL": "string", // 封面URL
|
||
"scheduledTime": 1234567890000, // 预约时间戳（毫秒）
|
||
"status": 1, // 会议状态：1-已预约，2-进行中，3-已结束，4-已取消
|
||
"creatorUserID": "string", // 创建者用户ID
|
||
"description": "string", // 会议描述
|
||
"duration": 60, // 会议时长（分钟）
|
||
"estimatedCount": 100, // 会议预估人数
|
||
"enableMic": true, // 是否开启连麦
|
||
"enableComment": true, // 是否开启评论
|
||
"anchorUserIDs": ["user1", "user2"], // 主播用户ID列表（多选）
|
||
"anchorUsers": [ // 主播用户信息列表
|
||
{
|
||
"userID": "user1",
|
||
"nickname": "主播1",
|
||
"faceURL": "https://example.com/avatar1.jpg"
|
||
},
|
||
{
|
||
"userID": "user2",
|
||
"nickname": "主播2",
|
||
"faceURL": "https://example.com/avatar2.jpg"
|
||
}
|
||
],
|
||
"createTime": 1234567890000, // 创建时间戳（毫秒）
|
||
"updateTime": 1234567890000, // 更新时间戳（毫秒）
|
||
"ex": "string", // 扩展字段
|
||
"groupID": "string" // 关联的群聊ID
|
||
},
|
||
"groupID": "string" // 创建的群聊ID
|
||
}
|
||
}
|
||
```
|
||
|
||
**说明：**
|
||
- 创建会议时会自动创建一个群聊，群聊名称为"群聊-[会议主题]"
|
||
- 会议封面会作为群聊头像
|
||
- 如果有主播列表，第一个主播自动成为群主，其他主播成为管理员
|
||
- 如果没有主播列表，创建者自动成为群主
|
||
|
||
---
|
||
|
||
### 2. 更新会议
|
||
|
||
**接口地址：** `POST /meeting/update_meeting`
|
||
|
||
**请求参数：**
|
||
|
||
```json
|
||
{
|
||
"meetingID": "string", // 会议ID（必填）
|
||
"subject": "string", // 会议主题（选填）
|
||
"coverURL": "string", // 封面URL（选填）
|
||
"scheduledTime": 1234567890000, // 预约时间戳（毫秒，选填）
|
||
"status": 2, // 会议状态：1-已预约，2-进行中，3-已结束，4-已取消（选填）
|
||
"description": "string", // 会议描述（选填）
|
||
"duration": 60, // 会议时长（分钟，选填）
|
||
"estimatedCount": 100, // 会议预估人数（选填）
|
||
"enableMic": true, // 是否开启连麦（选填，使用指针以区分是否设置）
|
||
"enableComment": true, // 是否开启评论（选填，使用指针以区分是否设置）
|
||
"anchorUserIDs": ["user1", "user2"], // 主播用户ID列表（多选，选填）
|
||
"ex": "string" // 扩展字段（选填）
|
||
}
|
||
```
|
||
|
||
**响应参数：**
|
||
|
||
```json
|
||
{
|
||
"errCode": 0,
|
||
"errMsg": "",
|
||
"errDlt": "",
|
||
"data": {
|
||
"meetingInfo": {
|
||
"meetingID": "string", // 会议ID
|
||
"subject": "string", // 会议主题
|
||
"coverURL": "string", // 封面URL
|
||
"scheduledTime": 1234567890000, // 预约时间戳（毫秒）
|
||
"status": 2, // 会议状态：1-已预约，2-进行中，3-已结束，4-已取消
|
||
"creatorUserID": "string", // 创建者用户ID
|
||
"description": "string", // 会议描述
|
||
"duration": 60, // 会议时长（分钟）
|
||
"estimatedCount": 100, // 会议预估人数
|
||
"enableMic": true, // 是否开启连麦
|
||
"enableComment": true, // 是否开启评论
|
||
"anchorUserIDs": ["user1", "user2"], // 主播用户ID列表（多选）
|
||
"anchorUsers": [ // 主播用户信息列表
|
||
{
|
||
"userID": "user1",
|
||
"nickname": "主播1",
|
||
"faceURL": "https://example.com/avatar1.jpg"
|
||
},
|
||
{
|
||
"userID": "user2",
|
||
"nickname": "主播2",
|
||
"faceURL": "https://example.com/avatar2.jpg"
|
||
}
|
||
],
|
||
"createTime": 1234567890000, // 创建时间戳（毫秒）
|
||
"updateTime": 1234567890000, // 更新时间戳（毫秒）
|
||
"ex": "string", // 扩展字段
|
||
"groupID": "string" // 关联的群聊ID
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
**说明：**
|
||
- 可以单独更新任意字段，只传需要更新的字段即可
|
||
- 更新主题时会同步更新群聊名称
|
||
- 更新封面时会同步更新群聊头像
|
||
- 更新主播列表时，第一个主播会成为群主，其他主播会成为管理员
|
||
- 只有创建者可以更新会议
|
||
|
||
---
|
||
|
||
### 3. 获取会议列表
|
||
|
||
**接口地址：** `POST /meeting/get_meetings`
|
||
|
||
**请求参数：**
|
||
|
||
```json
|
||
{
|
||
"creatorUserID": "string", // 创建者用户ID（选填）
|
||
"status": 1, // 会议状态（选填）：1-已预约，2-进行中，3-已结束，4-已取消
|
||
"keyword": "string", // 搜索关键词（选填，搜索主题和描述）
|
||
"startTime": 1234567890000, // 开始时间戳（毫秒，选填）
|
||
"endTime": 1234567890000, // 结束时间戳（毫秒，选填）
|
||
"pagination": {
|
||
"pageNumber": 1, // 页码，从1开始（选填，默认1）
|
||
"showNumber": 20 // 每页数量（选填，默认20）
|
||
}
|
||
}
|
||
```
|
||
|
||
**响应参数：**
|
||
|
||
```json
|
||
{
|
||
"errCode": 0,
|
||
"errMsg": "",
|
||
"errDlt": "",
|
||
"data": {
|
||
"total": 100, // 总数
|
||
"meetings": [
|
||
{
|
||
"meetingID": "string", // 会议ID
|
||
"subject": "string", // 会议主题
|
||
"coverURL": "string", // 封面URL
|
||
"scheduledTime": 1234567890000, // 预约时间戳（毫秒）
|
||
"status": 1, // 会议状态：1-已预约，2-进行中，3-已结束，4-已取消
|
||
"creatorUserID": "string", // 创建者用户ID
|
||
"description": "string", // 会议描述
|
||
"duration": 60, // 会议时长（分钟）
|
||
"estimatedCount": 100, // 会议预估人数
|
||
"enableMic": true, // 是否开启连麦
|
||
"enableComment": true, // 是否开启评论
|
||
"anchorUserIDs": ["user1", "user2"], // 主播用户ID列表（多选）
|
||
"anchorUsers": [ // 主播用户信息列表
|
||
{
|
||
"userID": "user1",
|
||
"nickname": "主播1",
|
||
"faceURL": "https://example.com/avatar1.jpg"
|
||
},
|
||
{
|
||
"userID": "user2",
|
||
"nickname": "主播2",
|
||
"faceURL": "https://example.com/avatar2.jpg"
|
||
}
|
||
],
|
||
"createTime": 1234567890000, // 创建时间戳（毫秒）
|
||
"updateTime": 1234567890000, // 更新时间戳（毫秒）
|
||
"ex": "string", // 扩展字段
|
||
"groupID": "string" // 关联的群聊ID
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
**说明：**
|
||
- 支持多种查询条件，可以组合使用
|
||
- 查询优先级：creatorUserID > status > keyword > startTime/endTime > 全部
|
||
- 支持分页查询
|
||
- 返回的会议信息中包含主播的完整用户信息（用户ID、昵称、头像等）
|
||
|
||
---
|
||
|
||
### 4. 删除会议
|
||
|
||
**接口地址：** `POST /meeting/delete_meeting`
|
||
|
||
**请求参数：**
|
||
|
||
```json
|
||
{
|
||
"meetingID": "string" // 会议ID（必填）
|
||
}
|
||
```
|
||
|
||
**响应参数：**
|
||
|
||
```json
|
||
{
|
||
"errCode": 0,
|
||
"errMsg": "",
|
||
"errDlt": "",
|
||
"data": {}
|
||
}
|
||
```
|
||
|
||
**说明：**
|
||
- 只有创建者可以删除会议
|
||
- 删除会议不会删除关联的群聊
|
||
|
||
---
|
||
|
||
## 会议状态说明
|
||
|
||
- `1` - 已预约：会议已创建，等待开始
|
||
- `2` - 进行中：会议正在进行
|
||
- `3` - 已结束：会议已结束（用户端不可见）
|
||
- `4` - 已取消：会议已取消（用户端不可见）
|
||
|
||
**注意：** 用户端接口只能查看状态1（已预约）和2（进行中）的会议，状态3（已结束）和4（已取消）的会议对用户端不可见。
|
||
|
||
---
|
||
|
||
## 通用响应格式
|
||
|
||
所有接口都遵循统一的响应格式：
|
||
|
||
```json
|
||
{
|
||
"errCode": 0, // 错误码，0表示成功
|
||
"errMsg": "", // 错误消息
|
||
"errDlt": "", // 错误详情
|
||
"data": {} // 响应数据
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 用户端接口
|
||
|
||
### 5. 获取会议信息（用户端）
|
||
|
||
**接口地址：** `POST /meeting/get_meeting`
|
||
|
||
**请求参数：**
|
||
|
||
```json
|
||
{
|
||
"meetingID": "string" // 会议ID（必填）
|
||
}
|
||
```
|
||
|
||
**响应参数：**
|
||
|
||
```json
|
||
{
|
||
"errCode": 0,
|
||
"errMsg": "",
|
||
"errDlt": "",
|
||
"data": {
|
||
"meetingInfo": {
|
||
"meetingID": "string", // 会议ID
|
||
"subject": "string", // 会议主题
|
||
"coverURL": "string", // 封面URL
|
||
"scheduledTime": 1234567890000, // 预约时间戳（毫秒）
|
||
"status": 1, // 会议状态：1-已预约，2-进行中
|
||
"description": "string", // 会议描述
|
||
"duration": 60, // 会议时长（分钟）
|
||
"enableMic": true, // 是否开启连麦
|
||
"enableComment": true, // 是否开启评论
|
||
"anchorUsers": [ // 主播用户信息列表
|
||
{
|
||
"userID": "user1",
|
||
"nickname": "主播1",
|
||
"faceURL": "https://example.com/avatar1.jpg"
|
||
},
|
||
{
|
||
"userID": "user2",
|
||
"nickname": "主播2",
|
||
"faceURL": "https://example.com/avatar2.jpg"
|
||
}
|
||
],
|
||
"groupID": "string" // 关联的群聊ID
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
**说明：**
|
||
- 用户端接口只显示状态为1（已预约）和2（进行中）的会议
|
||
- 如果会议状态为3（已结束）或4（已取消），将返回错误
|
||
- 用户端接口不返回管理字段（创建者ID、扩展字段、创建时间、更新时间等）
|
||
- 返回的主播信息包含用户ID、昵称、头像等完整用户信息
|
||
|
||
---
|
||
|
||
### 6. 获取会议列表（用户端）
|
||
|
||
**接口地址：** `POST /meeting/get_meetings_public`
|
||
|
||
**请求参数：**
|
||
|
||
```json
|
||
{
|
||
"status": 1, // 会议状态（选填）：1-已预约，2-进行中（只能查询这两个状态）
|
||
"keyword": "string", // 搜索关键词（选填，搜索主题和描述）
|
||
"startTime": 1234567890000, // 开始时间戳（毫秒，选填）
|
||
"endTime": 1234567890000, // 结束时间戳（毫秒，选填）
|
||
"pagination": {
|
||
"pageNumber": 1, // 页码，从1开始（选填，默认1）
|
||
"showNumber": 20 // 每页数量（选填，默认20）
|
||
}
|
||
}
|
||
```
|
||
|
||
**响应参数：**
|
||
|
||
```json
|
||
{
|
||
"errCode": 0,
|
||
"errMsg": "",
|
||
"errDlt": "",
|
||
"data": {
|
||
"total": 100, // 总数（只包含状态1和2的会议）
|
||
"meetings": [
|
||
{
|
||
"meetingID": "string", // 会议ID
|
||
"subject": "string", // 会议主题
|
||
"coverURL": "string", // 封面URL
|
||
"scheduledTime": 1234567890000, // 预约时间戳（毫秒）
|
||
"status": 1, // 会议状态：1-已预约，2-进行中
|
||
"description": "string", // 会议描述
|
||
"duration": 60, // 会议时长（分钟）
|
||
"enableMic": true, // 是否开启连麦
|
||
"enableComment": true, // 是否开启评论
|
||
"anchorUsers": [ // 主播用户信息列表
|
||
{
|
||
"userID": "user1",
|
||
"nickname": "主播1",
|
||
"faceURL": "https://example.com/avatar1.jpg"
|
||
},
|
||
{
|
||
"userID": "user2",
|
||
"nickname": "主播2",
|
||
"faceURL": "https://example.com/avatar2.jpg"
|
||
}
|
||
],
|
||
"groupID": "string" // 关联的群聊ID
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
**说明：**
|
||
- 用户端接口只显示状态为1（已预约）和2（进行中）的会议
|
||
- 如果指定status参数，只能传入1或2，传入其他值将返回错误
|
||
- 如果不指定status，查询结果会自动过滤，只返回状态1和2的会议
|
||
- 用户端接口不支持按创建者查询
|
||
- 用户端接口不返回管理字段（创建者ID、扩展字段、创建时间、更新时间等）
|
||
- 返回的主播信息包含用户ID、昵称、头像等完整用户信息
|
||
|
||
---
|
||
|
||
## 注意事项
|
||
|
||
1. 所有接口都需要在请求头中携带 `token` 进行身份验证
|
||
2. 创建和更新会议时，预约时间不能早于当前时间
|
||
3. 创建会议时会自动创建关联的群聊，群聊名称为"群聊-[会议主题]"
|
||
4. 更新会议主题或封面时，会同步更新关联群聊的名称或头像
|
||
5. 只有会议创建者可以更新和删除会议
|
||
6. 用户端接口只提供查看功能，不包含创建、更新、删除等管理功能
|
||
7. 用户端接口返回的数据已过滤管理字段（创建者ID、扩展字段、创建时间、更新时间等）
|
||
8. 用户端接口只显示状态为1（已预约）和2（进行中）的会议，状态3（已结束）和4（已取消）的会议对用户端不可见
|