直播管理

直播标题 *

直播分类 *

直播描述

开始时间 *

结束时间 *

直播封面

主播名称 *

启用观看时长统计

推流信息

RTMP推流地址

推流密钥

HLS拉流地址

子直播设置

子直播 1

子直播标题

开始时间

结束时间

确认删除

您确定要删除这个直播吗？此操作不可撤销。

API文档

API概述

本API提供了直播系统的核心功能，包括直播管理、用户统计等。所有API请求均需在HTTP头中包含Authorization字段进行身份验证。

Authorization: Bearer {your_api_token}

直播管理API

GET 获取直播列表

/api/live

请求参数

参数名	类型	描述	是否必填
page	integer	页码，默认1	否
limit	integer	每页数量，默认10	否
category	string	直播分类	否
status	string	直播状态：upcoming, live, ended	否

响应示例

{
  "code": 200,
  "data": {
    "total": 8,
    "page": 1,
    "limit": 10,
    "list": [
      {
        "id": 1,
        "title": "WebRTC实时通信技术详解",
        "description": "深入探讨WebRTC技术原理与应用场景",
        "coverImage": "https://example.com/images/live1.jpg",
        "startTime": "2025-10-28T14:00:00",
        "endTime": "2025-10-28T16:00:00",
        "category": "tech",
        "categoryName": "科技",
        "status": "upcoming",
        "viewers": 0,
        "creator": "张工程师",
        "enableDurationTracking": true,
        "hasSubLive": true
      },
      // 更多直播...
    ]
  }
}

POST 创建直播

/api/live

请求体

{
  "title": "新的直播标题",
  "description": "直播描述内容",
  "coverImage": "https://example.com/images/new-cover.jpg",
  "startTime": "2025-10-30T10:00:00",
  "endTime": "2025-10-30T12:00:00",
  "category": "education",
  "creator": "李老师",
  "enableDurationTracking": true,
  "subLives": [
    {
      "title": "子直播1标题",
      "startTime": "2025-10-30T10:00:00",
      "endTime": "2025-10-30T11:00:00"
    },
    {
      "title": "子直播2标题",
      "startTime": "2025-10-30T11:00:00",
      "endTime": "2025-10-30T12:00:00"
    }
  ]
}

响应示例

{
  "code": 200,
  "data": {
    "id": 9,
    "title": "新的直播标题",
    "rtmpUrl": "rtmp://example.com/live/stream9",
    "streamKey": "sk_987654",
    "hlsUrl": "https://example.com/live/9/stream.m3u8"
  },
  "message": "直播创建成功"
}

用户统计API

GET 获取直播观看统计

/api/live/:id/stats

响应示例

{
  "code": 200,
  "data": {
    "liveId": 2,
    "title": "2025年最新医疗技术研讨会",
    "totalViewers": 128,
    "maxConcurrentViewers": 86,
    "avgWatchDuration": 15, // 分钟
    "interactionRate": 35, // 百分比
    "viewersData": [45, 60, 75, 90, 105, 120, 115, 128]
  }
}

GET 导出用户观看时长

/api/live/:id/export

响应示例

{
  "code": 200,
  "data": {
    "downloadUrl": "https://example.com/exports/live2_viewers.xlsx",
    "fileName": "live2_viewers.xlsx"
  },
  "message": "导出成功"
}

0

0

0

0分钟

直播列表

直播观看趋势

直播分类分布

子直播 1

请求参数

响应示例

请求体

响应示例

响应示例

响应示例