Record History API

录制历史相关接口文档。

查询直播记录

查询指定房间的直播记录列表，支持分页和时间范围筛选。

接口地址: GET /record-history/list

请求参数:

参数名	类型	必填	说明
room_id	string	是	房间号
platform	string	是	平台名称
page	number	否	页码，默认为 1
pageSize	number	否	每页条数，默认为 100
startTime	number	否	开始时间(时间戳,单位:秒)
endTime	number	否	结束时间(时间戳,单位:秒)

返回数据:

{
  "code": 200,
  "data": [
    {
      "id": 1,
      "created_at": 1730275200,
      "streamer_id": 1,
      "live_id": "live_123456",
      "live_start_time": 1730275200,
      "record_start_time": 1730275210,
      "record_end_time": 1730280000,
      "title": "直播标题",
      "video_file": "/path/to/video.flv",
      "video_duration": 4790.5,
      "danma_num": 1250,
      "interact_num": 320,
      "danma_density": 0.26
    }
  ],
  "pagination": {
    "total": 100,
    "page": 1,
    "pageSize": 100
  }
}

返回参数说明:

参数名	类型	说明
code	number	状态码,200表示成功
data	array	记录列表
data[].id	number	记录ID
data[].streamer_id	number	主播ID
data[].live_id	string	直播ID
data[].live_start_time	number	直播开始时间(时间戳,单位:秒)
data[].record_start_time	number	录制开始时间(时间戳,单位:秒)
data[].record_end_time	number	录制结束时间(时间戳,单位:秒)
data[].title	string	直播标题
data[].video_file	string	视频文件路径
data[].video_duration	number	视频持续时长(单位:秒,浮点数)
data[].danma_num	number	弹幕数量
data[].interact_num	number	互动人数
data[].danma_density	number	弹幕密度(弹幕数/视频时长,保留两位小数)
data[].created_at	number	创建时间(时间戳,单位:秒)
pagination	object	分页信息
pagination.total	number	总记录数
pagination.page	number	当前页码
pagination.pageSize	number	每页条数

删除直播记录

删除指定的直播记录。

接口地址: DELETE /record-history/:id

路径参数:

参数名	类型	必填	说明
id	number	是	记录ID

返回数据:

{
  "code": 200,
  "message": "删除成功"
}

返回参数说明:

参数名	类型	说明
code	number	状态码,200表示成功
message	string	操作结果信息

WARNING

该操作仅删除数据库记录,不会删除实际的视频文件。

获取视频文件路径

获取指定记录的视频文件路径。

接口地址: GET /record-history/video/:id

路径参数:

参数名	类型	必填	说明
id	number	是	记录ID

返回数据:

"/path/to/video.flv"

返回参数说明:

返回视频文件的完整路径字符串。

TIP

系统会自动检测视频文件是否存在,如果原始文件不存在,会尝试查找对应的 .mp4 文件。

下载视频文件

获取视频文件的下载信息。

接口地址: GET /record-history/download/:id

路径参数:

参数名	类型	必填	说明
id	number	是	记录ID

返回数据:

{
  "fileId": "abc123def456",
  "type": "flv"
}

返回参数说明:

参数名	类型	说明
fileId	string	文件ID,用于后续的文件下载操作
type	string	视频文件类型,可能的值: flv(FLV格式)、ts(TS格式)或空字符串

TIP

返回的 fileId 可用于后续的文件下载操作,type 字段表示视频文件类型(如 flv、ts 等)。