异步批量转存录制文件到点播

接口URL

http://api.polyv.net/live/v3/channel/record/convert

接口说明

1、接口用于批量转存直播录制文件到回放列表
2、该接口为异步处理,如果当前提交的文件如果正在处理,会返回 data: processing
3、接口支持https

支持格式

JSON

请求方式

POST

请求参数

参数名 必选 类型 说明
appId string 管理员的appId
timestamp long 13位当前时间戳
sign string 签名值
channelId string 频道ID
fileIds string 要转存的录制视频文件ID,多个id用英文逗号, 分隔
fileName String 转存后的文件名,目前暂不支持传多个文件名
cataId long 转存到点播的目录ID, 默认为点播的根目录ID
callbackUrl string 转存成功时候回调通知的url,通知的相关参数见附录

响应成功JSON示例:

//提交的视频正在转存处理中
{
    "code": 200,
    "status": "success",
    "message": "",
    "data": "processing."
}
//转存任务提交成功
{
    "code": 200,
    "status": "success",
    "message": "",
    "data": "submit success."
}

响应失败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 响应代码,成功为200,失败为400,签名错误为401,异常错误500
status 成功为success,失败为error
message 错误时为错误提示消息
data 成功响应时为相关的信息 "processing." 转存任务正在处理中 "submit success." 转存任务提交成功

php请求示例

<?php
//引用config.php
include 'config.php';

$params = array(
  'appId' => "填写获取到的appId",
  'timestamp' => "填写13位时间戳",
  'channelId' => "填写频道号",
  'fileIds' => "aaaa",
  'fileName' => "转存测试",
  'callbackUrl'=> "http://demo.polyv.net/wfy/test.php"
);

//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法


$url="http://api.polyv.net/live/v3/channel/record/convert";

function post($url, $post_data = '', $timeout = 5){
   $ch = curl_init();
   curl_setopt ($ch, CURLOPT_URL, $url);
   curl_setopt ($ch, CURLOPT_POST, 1);
   if($post_data != ''){
      curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
   }

   curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
   curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
   curl_setopt($ch, CURLOPT_HEADER, false);
   $file_contents = curl_exec($ch);
   curl_close($ch);
   return $file_contents;
}

$params["sign"] = $sign;
echo post($url, $params);
?>

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

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

回调说明

该接口为异步处理,如果需要获取转存的结果,可以在请求接口时提交callbackUrl 参数,在程序转存成功后,会对callbackUrl 进行回调通知

转存成功回调参数

转存成功回调参数参照 http://dev.polyv.net/2018/liveproduct/l-manual/l-function-intro/development-settings/playback-callback-url/

转存失败回调参数

参数 说明
status 接口处理结果,取值:success(成功),error(出错)
code 错误码,userExpired-用户已过期;spaceOverSize-点播空间不足;unknown-未知异常
userId 用户id
channelId 频道号
fileId 转存的文件ID
sign 校验的加密字符串,生成的规则md5(AppSecret+timestamp),AppSecret是直播系统的用密匙
timestamp 13位时间戳
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...