分页查询频道直播暂存列表

接口描述

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

接口URL

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

请求方式

GET

接口约束

1、接口调用有频率限制，建议使用 HTTPS，详见调用限制。

2、请在服务端生成签名并调用接口，严禁在 Web、App、小程序等客户端保存或使用 appSecret。

3、返回的仅为当前账号有权限访问的频道暂存文件；临时文件到期后不再返回。

请求参数描述

请求示例

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

响应参数描述

error参数描述

data参数描述

contents参数描述

响应示例

成功示例：

{
  "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": ""
      }
    ]
  }
}

异常示例：

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