后端接口 TODO 清单 - 消息聊天模块

1. 获取会话列表

文件: MessagesActivity.java 接口路径: GET /api/conversations 请求参数:

userId: 当前用户ID（从token中获取）
page (可选): 页码
pageSize (可选): 每页数量 返回数据:

{
  "code": 200,
  "data": [
    {
      "id": "string",
      "title": "string",
      "lastMessage": "string",
      "timeText": "string",
      "unreadCount": "number",
      "isMuted": "boolean",
      "avatarUrl": "string"
    }
  ]
}

2. 获取会话消息列表

文件: ConversationActivity.java 接口路径: GET /api/conversations/{conversationId}/messages 请求参数:

conversationId: 会话ID（路径参数）
page (可选): 页码
pageSize (可选): 每页数量，默认20
beforeMessageId (可选): 获取指定消息ID之前的消息 返回数据:

{
  "code": 200,
  "data": [
    {
      "messageId": "string",
      "userId": "string",
      "username": "string",
      "avatarUrl": "string",
      "message": "string",
      "timestamp": "number",
      "status": "sent|read"
    }
  ]
}

3. 发送私信消息

文件: ConversationActivity.java 接口路径: POST /api/conversations/{conversationId}/messages 请求参数:

{
  "conversationId": "string",
  "message": "string",
  "userId": "string"
}

返回数据: 返回创建的 ChatMessage 对象

4. 删除消息

文件: ConversationActivity.java 接口路径: DELETE /api/messages/{messageId} 请求参数: messageId (路径参数) 返回数据:

{
  "code": 200,
  "data": {
    "success": true
  }
}

5. 标记会话为已读

文件: MessagesActivity.java, ConversationActivity.java 接口路径: POST /api/conversations/{conversationId}/read 请求参数:

{
  "conversationId": "string",
  "userId": "string"
}

返回数据:

{
  "code": 200,
  "data": {
    "success": true
  }
}

6. 删除会话

文件: MessagesActivity.java 接口路径: DELETE /api/conversations/{conversationId} 请求参数: conversationId (路径参数) 返回数据:

{
  "code": 200,
  "data": {
    "success": true
  }
}

7. 搜索会话

文件: MessagesActivity.java 接口路径: GET /api/conversations/search 请求参数:

keyword: 搜索关键词
userId: 当前用户ID（从token中获取） 返回数据: 同获取会话列表接口

8. 获取未读消息总数

文件: MainActivity.java 接口路径: GET /api/messages/unread/count 请求参数: userId（从token中获取） 返回数据:

{
  "code": 200,
  "data": {
    "unreadCount": "number"
  }
}

2.7 KiB Raw Blame History Unescape Escape