获取频道回放的详细信息

接口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值
channelId int 频道号
page int 页码,默认为1
pageSize int 页面大小,默认为12,上限为1000
startTime string 开始时间,格式为yyyyMMddHHmmss。筛选直播开始时间大于等于该参数的回放
endTime string 结束时间,格式为yyyyMMddHHmmss。筛选直播开始时间小于等于该参数的回放
fileId string 录制id,使用该参数则为精确查询,忽略日期区间过滤

响应成功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

{
    "code": 400,
    "status": "error",
    "message": "appId is required.",
    "data": ""
}

appId不正确

{
    "code": 400,
    "status": "error",
    "message": "application not found.",
    "data": ""
}

时间戳错误

{
    "code": 400,
    "status": "error",
    "message": "invalid timestamp.",
    "data": ""
}

签名错误

{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}

频道号格式错误

{
  "code": 400, 
  "status": "error", 
  "message": "param is not digit: dsadasd", 
  "data": ""
}

日期格式错误

{
  "code": 400, 
  "status": "error", 
  "message": "invalid date time format", 
  "data": ""
}

数值范围错误

{
  "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
//引用config.php
include 'config.php';

$params = array(
  'appId' => $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;
?>

签名规则(config.php文件代码查看)

http://dev.polyv.net/2018/liveproduct/l-api/rule/sign/

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...