zhibo/模块文档/03-直播间弹幕模块.md

直播间弹幕模块接口文档

模块概述

直播间弹幕模块提供弹幕消息的发送和历史记录查询功能。

---

接口列表

1. 获取历史弹幕

接口路径: GET /api/front/live/public/rooms/{roomId}/messages

请求参数:

roomId: 房间ID (路径参数)
limit: 获取最近N条消息 (可选，默认50)

返回参数:

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "id": "消息ID",
      "userId": 用户ID,
      "nickname": "用户昵称",
      "avatar": "用户头像URL",
      "content": "弹幕内容",
      "type": "text",
      "createTime": "2024-12-30T10:30:00"
    }
  ]
}

---

2. 发送弹幕消息

接口路径: POST /api/front/live/public/rooms/{roomId}/messages

请求头:

Authorization: Bearer {token}

请求参数:

{
  "roomId": "房间ID",
  "content": "弹幕内容",
  "type": "text"
}

返回参数:

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "消息ID",
    "userId": 用户ID,
    "nickname": "用户昵称",
    "avatar": "用户头像URL",
    "content": "弹幕内容",
    "type": "text",
    "createTime": "2024-12-30T10:30:00"
  }
}