lal流媒体服务器的HTTP API接口

发表于 | 分类于
| 字数统计: 1.6k

lal地址： https://github.com/q191201771/lal

接口列表

接口分为两大类：

  • 查询类型的，以/api/stat开头
  • 控制类型的，以/api/ctrl开头
1
2
3
4
5
6
1.1. /api/stat/group     // 查询特定group的信息
1.2. /api/stat/all_group // 查询所有group的信息
1.3. /api/stat/lal_info  // 查询服务器信息

2.1. /api/ctrl/start_pull       // 控制服务器从远端拉流至本地
2.2. /api/ctrl/kick_out_session // 强行踢出关闭指定session，比如rtmp pub推流会话、http-flv sub拉流会话等

名词解释：

  • group: lal中的group是群组的概念，lal作为流媒体服务器，通过流名称将每1路输入流转发给1~n路输出流，流名称相同的输入输出流被同1个group群组管理。

所有接口的返回结果中，必含的一级参数：

1
2
3
4
5
{
    "error_code": 0,
    "desp": "succ",
    "data": ...
}

error_code列表：

error_codedesp说明
0succ调用成功
1001group not foundgroup不存在
1002param missing必填参数缺失
1003session not foundsession不存在

接口详情

1.1. /api/stat/group

  • 简要描述： 查询指定group的信息
  • 请求URL： http://127.0.0.1:8083/api/stat/group?stream_name=test110
  • 请求方式： HTTP GET
  • 请求参数：
    • stream_name | 必填项 | 指定group的流名称
  • 返回值error_code可能取值：
    • 0 group存在，查询成功
    • 1001 group不存在
    • 1002 必填参数缺失

返回示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
{
  "error_code": 0, // 接口返回值，0表示成功
  "desp": "succ",  // 接口返回描述，"succ"表示成功
  "data": {
    "stream_name": "test110", // 流名称
    "audio_codec": "AAC",     // 音频编码格式 "AAC"
    "video_codec": "H264",    // 视频编码格式 "H264" | "H265"
    "video_width": 640,       // 视频宽
    "video_height": 360,      // 视频高
    "pub": {                  // 接收推流的信息
      "protocol": "RTMP",                      // 推流协议 "RTMP" | "RTSP"
      "session_id": "RTMPPUBSUB1",             // 会话ID，会话全局唯一标识
      "start_time": "2020-10-11 19:17:41.586", // 推流开始时间
      "remote_addr": "127.0.0.1:61353",        // 对端地址
      "read_bytes_sum": 9219247,               // 累计读取数据大小（从推流开始时计算）
      "wrote_bytes_sum": 3500,                 // 累计发送数据大小
      "bitrate": 588                           // 最近5秒码率，单位kbit/s。如无特殊声明，统计的是网络接收的所有数据
    },
    "subs": [                 // 拉流的信息，可能存在多种协议，每种协议可能存在多个会话连接
      {
        "protocol": "HTTP-FLV",                  // 拉流协议 "RTMP" | "HTTP-FLV" | "HTTP-TS"
        "session_id": "FLVSUB1",                 // 会话ID，会话全局唯一标识
        "start_time": "2020-10-11 19:19:21.724", // 拉流开始时间
        "remote_addr": "127.0.0.1:61785",        // 对端地址
        "read_bytes_sum": 134,                   // 累计读取数据大小（从拉流开始时计算）
        "wrote_bytes_sum": 2944020,              // 累计发送数据大小
        "bitrate": 591                           // 最近5秒码率，单位kbit/s。如无特殊声明，统计的是网络发送的所有数据
      }
    ],
    "pull": {}, // 该节点从其他节点拉流回源信息，内部字段和上面pub的内部字段相同，不再赘述
    "pushs":[]  // 主动外连转推信息，暂时不提供
  }
}

1.2. /api/stat/all_group

  • 简要描述： 查询所有group的信息
  • 请求URL示例： http://127.0.0.1:8083/api/stat/all_group
  • 请求方式： HTTP GET
  • 请求参数： 无
  • 返回值error_code可能取值：
    • 0 查询成功

返回示例：

1
2
3
4
5
6
7
8
9
{
    "error_code": 0,
    "desp": "succ",
    "data": {
        "groups": [
            ...      // 数组内每个元素的内容格式和/api/stat/group接口中data字段相同，不再赘述
        ]
    }
}

1.3. /api/stat/lal_info

  • 简要描述： 查询服务器信息
  • 请求URL示例： http://127.0.0.1:8083/api/stat/lal_info
  • 请求方式： HTTP GET
  • 请求参数： 无
  • 返回值error_code可能取值：
    • 0 查询成功

返回示例：

1
2
3
4
5
6
7
8
9
10
11
12
{
  "error_code": 0,
  "desp": "succ",
  "data": {
    "server_id": "1",
    "bin_info": "GitTag=v0.17.0. GitCommitLog=bbf850aca2d4f3e55380d44ca9c3a16be60c8d39 ${NewVersion} -> version.go. GitStatus= M CHANGELOG.md | M gen_tag.sh | M pkg/base/version.go. BuildTime=2020.11.21.173812. GoVersion=go version go1.14.2 darwin/amd64. runtime=darwin/amd64.",
    "lal_version": "v0.17.0",               // lal可执行文件版本信息
    "api_version": "v0.1.2",                // HTTP API接口版本信息
    "notify_version": "v0.0.4",             // HTTP Notify版本信息
    "start_time": "2020-11-21 17:34:53.973" // lal进程启动时间
  }
}

2.1. /api/ctrl/start_pull

  • 简要描述： 控制服务器主动从远端拉流至本地
  • 请求方式： HTTP POST

请求示例：

1
$curl -H "Content-Type:application/json" -X POST -d '{"protocol": "rtmp", "addr":"127.0.0.1:19550", "app_name":"live", "stream_name":"test110", "url_param":"token=aaa&p2=bbb"}' http://127.0.0.1:8083/api/ctrl/start_pull

请求参数说明：

1
2
3
4
5
6
7
{
  "protocol": "rtmp",            // 必填项，目前只支持 rtmp
  "addr":"127.0.0.1:19550",      // 必填项，远端地址
  "app_name":"live",             // 必填项，app name
  "stream_name":"test110",       // 必填项，流名称
  "url_param":"token=aaa&p2=bbb" // 选填项，url参数
}

返回值error_code可能取值：

  • 0 请求接口成功。注意，返回成功并不保证从远端拉流成功
  • 1002 参数错误

2.2. /api/ctrl/kick_out_session

  • 简要描述： 强行踢出关闭指定session，比如rtmp pub推流会话、http-flv sub拉流会话等
  • 请求方式： HTTP POST

请求示例：

1
$curl -H "Content-Type:application/json" -X POST -d '{"stream_name": "test110", "session_id": "FLVSUB1"}' http://127.0.0.1:8083/api/ctrl/kick_out_session

请求参数说明：

1
2
3
4
{
  "stream_name": "test110", // 必填项，流名称
  "session_id": "FLVSUB1"   // 必填项，会话唯一标识
}

返回值error_code可能取值：

  • 0 请求接口成功。指定会话被关闭
  • 1001 指定流名称对应的group不存在
  • 1003 指定会话不存在

其他

HTTP API模块还提供一个API列表页面，地址为http://127.0.0.1:8083/api/list

1
2
3
4
5
6
7
本文档基于版本：
lal tag: v0.17.0
tag之后的commit id: 0935c58a0d0682f031b25e2b4304ecb825dd6b99
http api version: v0.1.2
http notify version: v0.0.4

文档最后修改时间：20201121

本文完，作者yoko，尊重劳动人民成果，转载请注明原文出处： https://pengrl.com/p/20100/

0%