查询relay状态

2026年 5月 20日下午3:36

**简要描述：**

- 查询所有relay任务

**请求URL：** 
- ` http://serverip:8000/api/relays`
 
**请求方式：**
- GET

**返回示例**

``` 
{
 "code": 200,
 "error": "",
 "data": {
 "0d9f96627287fda349e99a2531bbe872": {
 "mode": 0,
 "status": 2,
 "in_url": "/root/b.flv",
 "out_url": "rtmp://localhost/live/b",
 "disable_audio": false
 },
 "3dea86cf2d77492f77b94e1404e107c7": {
 "mode": 0,
 "status": 2,
 "in_url": "/root/xxm_hd.mp4",
 "out_url": "rtmp://192.168.0.2/live/s",
 "disable_audio": false
 },
 "c5889b5841f276f5c5cbbddedb704bc5": {
 "mode": 0,
 "status": 2,
 "in_url": "/root/d.flv",
 "out_url": "rtmp://localhost/live/d",
 "disable_audio": false
 },
 "db04744c64580e3a9d22112a48294f4e": {
 "mode": 0,
 "status": 2,
 "in_url": "/root/c.flv",
 "out_url": "rtmp://localhost/live/c",
 "disable_audio": false
 },
 "edaef656f07404370964f8cfcc37a4ac": {
 "mode": 0,
 "status": 2,
 "in_url": "rtsp://admin:admin@192.168.0.112:554/Streaming/channels/102",
 "out_url": "rtmp://192.168.0.3/live/ss",
 "disable_audio": false
 },
 "f227273e7706e6420f341fcb66a67be0": {
 "mode": 0,
 "status": 2,
 "in_url": "/root/a.flv",
 "out_url": "rtmp://localhost/live/a",
 "disable_audio": false
 }
 }
}
```

**返回参数说明**

|参数名|类型|说明|
|:----- |:-----|----- |
|mode |int |任务创建时的 mode |
|status |int |任务现在的 状态 0-停止 1-正在连接 2-任务开始 3-输入流打开错误 4-输出流打开错误 5-正在准备重连|
|in_url |int |任务创建时的 输入流地址 |
|out_url |int |任务创建时的 输出流地址 |
|disable_audio |int |任务创建时 是否设置了关闭音频|
|comment |string |任务备注|
 
**简要描述：**

- 查询单个relay任务

**请求URL：** 
- ` http://serverip:8000/api/relay/{id}`
 
**请求方式：**
- GET

**URL参数**

|参数名|类型|说明|
|:----- |:-----|----- |
|id |int |任务创建后返回的任务id |

**返回示例**

``` 
{
 "code": 200,
 "error": "",
 "data": {
 "mode": 0,
 "status": 2,
 "in_url": "rtsp://admin:chen2509@192.168.0.112:554/Streaming/channels/101",
 "out_url": "rtmp://localhost:1935/live/01_192168000112_101",
 "disable_audio": false
 }
}
```

**返回参数说明**

**备注说明**
- 当任务以mode = 1 创建时，调用查询relay任务状态是保持心跳的方法，需要以30秒一次的频率调用。
- 查询所有任务时是url是 relays，查询单个任务时是relay，请注意不要搞错。

文档

查询relay状态