分頁查詢頻道直播暫存列表

介面描述

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."
  }
}