# 获取频道回放的详细信息 ### 接口URL ``` https://api.polyv.net/live/v3/channel/playback/list-playback-detail ``` ### 接口说明 ``` 1、接口用于获取频道回放的详细信息 2、接口支持https ``` ### 支持格式 ``` JSON ``` ### 请求方式 ``` GET ``` ### 请求数限制 ``` TRUE ``` ### 请求参数 | 参数名 | 必选 | 类型 | 说明 | | --------- | -- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | appId | 是 | string | 从API设置中获取，在直播系统登记的appId | | timestamp | 是 | long | 当前13位毫秒级时间戳，3分钟内有效 | | sign | 是 | String | 签名，为32位大写的MD5值,`生成签名的appSecret密钥作为通信数据安全的关键信息，严禁保存在客户端直接使用，所有API都必须通过客户自己服务器中转调用POLYV服务器获取响应数据`【详见[签名生成规则](https://git.polyv.net/help-center/document-center/-/blob/master/live/api/buildSign/README.md)】 | | channelId | 是 | int | 频道号 | | page | 否 | int | 页码，默认为1 | | pageSize | 否 | int | 页面大小，默认为12，上限为1000 | | startTime | 否 | string | 开始时间，格式为yyyyMMddHHmmss。筛选直播开始时间大于等于该参数的回放 | | endTime | 否 | string | 结束时间，格式为yyyyMMddHHmmss。筛选直播开始时间小于等于该参数的回放 | | fileId | 否 | string | 录制id，使用该参数则为精确查询，忽略日期区间过滤 | ### 响应成功JSON示例： ```json { "code": 200, "status": "success", "message": "", "data": { "pageNumber": 1, "totalPages": 1, "pageSize": 1, "contents": [ { "channelId": 352078, "sessionId": "fhbc977k1j", "sessionIds": "[\"20191028151506,922,fhbc977k1j\"]", "fileId": "73fe1f8f609ce315d7d8ab8a5a3c839e", "title": "title", "startTime": "20191028151506", "endTime": "20191028153028", "duration": 922, "videoId": "eba9c64cae", "mp4Url": "http://dl.videocc.net/23c0193d81/none_23c0193d819dcfc3e9184662f4fa56cd_1.mp4", "recordPPTStatus": 1, "recordPPTUrl": "http://dl.videocc.net/23c0193d81/none_23c0193d813efe97b0578b0c25ef2788_1.mp4", "zipUrl": "http://liveimages.videocc.net/ppt/23c0193d819dcfc3e9184662f4fa56cd.zip", "zipStatus": 1, "origin": "auto" } ] } } ``` ### 响应失败JSON示例： 未输入appId ```json { "code": 400, "status": "error", "message": "appId is required.", "data": "" } ``` appId不正确 ```json { "code": 400, "status": "error", "message": "application not found.", "data": "" } ``` 时间戳错误 ```json { "code": 400, "status": "error", "message": "invalid timestamp.", "data": "" } ``` 签名错误 ```json { "code": 403, "status": "error", "message": "invalid signature.", "data": "" } ``` 频道号格式错误 ```json { "code": 400, "status": "error", "message": "param is not digit: dsadasd", "data": "" } ``` 日期格式错误 ```json { "code": 400, "status": "error", "message": "invalid date time format", "data": "" } ``` 数值范围错误 ```json { "code": 400, "status": "error", "message": "number range error", "data": "" } ``` ### 字段说明 | 参数名 | 说明 | | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | code | 响应代码，成功为200，失败为400，签名错误为401，异常错误500 | | status | 成功为success，失败为error | | message | 错误时为错误提示消息 | | data | 成功响应时为回放详情分页数据 | | pageNumber | 当前页码 | | totalPages | 总页数 | | pageSize | 页面大小 | | contents | 回放详情数据列表 | | channelId | 所属频道号 | | sessionId | 回放对应的单个场次id | | sessionIds | 场次和时间对应的数组字符串，格式：\["20190703145126,4,fdqbopvtnv","20190703145126,8,fdqbopvtnv"] ，其中："20190703145126,4,fdqbopvtnv" 第一个字段是开始时间，第二个字段是直播的时长，第三个是对应的sessionId。 | | fileId | 对应的录制文件id | | title | 回放标题 | | startTime | 直播开始时间，格式为yyyyMMddHHmmss。筛选直播开始时间大于等于该参数的回放 | | endTime | 直播结束时间，格式为yyyyMMddHHmmss。筛选直播开始时间小于等于该参数的回放 | | duration | 直播时长，单位秒 | | videoId | 回放id，可用于SDK播放在线回放 | | mp4Url | 回放转存后的mp4下载地址 | | recordPPTStatus | 重制状态，1为重制已经可用，0为重制未完成 | | recordPPTUrl | 当重制状态为1时，该字段为重制的mp4下载地址 | | zipUrl | 离线包下载地址 | | zipStatus | 离线包状态，0代表还未打包完成，1代表已完成 | | origin | 回放来源，manual-云录制，auto-自动录制，merge-合并，clip-裁剪 | ### php请求示例 ```php $appId, 'timestamp' => $timestamp, 'channelId' => 206204, 'page' => 1, 'pageSize' => 5, 'startTime' => '20191001120000', 'endTime' => '20191015235959' ); //生成sign $sign = getSign($params); //详细查看config.php文件的getSign方法 $params['sign'] = $sign; $url = "https://api.polyv.net/live/v3/channel/playback/list-playback-detail?".http_build_query($params); $curl = curl_init(); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); curl_setopt($curl, CURLOPT_TIMEOUT, 500); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_POST, 0); $res = curl_exec($curl); curl_close($curl); echo $res; ?> ```