Paginated Query of Channel Live Stream Temporary Files

Interface Description

1、分页查询指定频道的直播暂存文件。
2、暂存文件的剩余可用天数以账号当前生效的暂存保留配置为准。
3、接口支持 HTTPS 协议。

Interface URL

https://api.polyv.net/live/v4/channel/record-file/list

Request Method

GET

Interface Constraints

1. The interface has a frequency limit. HTTPS is recommended. See Call Limits for details.

2. Generate the signature and call the interface on the server side. It is strictly prohibited to save or use appSecret in clients such as Web, App, or Mini Programs.

3. Only temporary files of channels that the current account has permission to access are returned; expired temporary files will no longer be returned.

Request Parameter Description

Request Example

https://api.polyv.net/live/v4/channel/record-file/list?appId=yourAppId&timestamp=1700000000000&sign=YOUR_SIGN&channelId=1234567&pageNumber=1&pageSize=10

Response Parameter Description

error Parameter Description

data Parameter Description

contents Parameter Description

Response Example

Success example:

{
  "code": 200,
  "status": "success",
  "success": true,
  "requestId": "示例请求ID",
  "error": null,
  "data": {
    "pageNumber": 1,
    "pageSize": 10,
    "totalPages": 1,
    "totalItems": 1,
    "contents": [
      {
        "fileId": "示例暂存文件ID",
        "channelId": 1234567,
        "name": "直播录制文件",
        "startTime": "20260724074050",
        "endTime": "20260724142655",
        "duration": 24465,
        "filesize": 0,
        "mp4": "",
        "m3u8": "",
        "channelSessionId": "示例场次ID",
        "originSessionId": "示例场次ID",
        "origin": "complete",
        "permanentStorage": "N",
        "daysLeft": 53,
        "watchUrl": ""
      }
    ]
  }
}

Error example:

{
  "code": 20000,
  "status": "error",
  "success": false,
  "error": {
    "code": 20000,
    "desc": "appId is required."
  }
}