提交视频裁剪任务

接口URL

http://api.polyv.net/v2/video/{userid}/clip

接口说明

1、提交视频裁剪的任务
2、{userid}为用户ID
3、接口请求成功会返回裁剪后新视频的vid

支持格式

JSON

请求方式

POST

请求参数

参数名 必选 类型及范围 说明
vid true string 视频ID
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
title true string 裁剪后的视频名称
timeFrame true string json格式的特定时间段,格式为[{"start":1,"end":6},{"start":10,"end":16}]. 时间段数量不能超过5个,每个片段开始时间不能大于结束时间,开始与结束时间间隔需要超过或者等于5秒,结束时间不能超过视频的播放时长

返回结果(data里为裁剪出来的视频vid)

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": "vid"
}

失败返回json(不带jsonp)

{
    code: 400,
    status: "error",
    message: "ptime is too old.",
    data: ""
}

响应说明

错误代码 message 说明
400 sign can not be empty. 加密串为空
400 ptime is too old. 时间戳过期
400 ptime is illegal. 时间戳参数格式不对或者超过当前时间3分钟
400 Could not find user by userid. userid不存在
400 the sign is not right. 加密串不正确
410 vid is blank. vid为空
411 timeFrame is blank. 时间段为空
412 vid doesn't exist. vid不存在
413 illegal timeFrames. timeframe的json格式有问题
414 timeFrames's size exceed 5. timeFrame时间段超过5段
415 illegal timeFrames. timeFrame的结束时间小于开始时间
416 illegal timeFrames. timeFrame时间段长度小于5秒
417 illegal timeFrames. timeFrame的结束时间超过视频的时长
418/419 inital clip task filed. 初始化任务失败,需要查看后台日志原因
500 save clip task failed. 后台程序抛异常
200 success 提交成功

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="3828390191";
$title="test";
$timeFrame="[{\"end\":12,\"start\":5},{\"end\":35,\"start\":20},{\"end\":82,\"start\":71},{\"end\":195,\"start\":111},{\"end\":236,\"start\":215}]";
$ptime=time()*1000;//13位
$vid="382839019131be68715e9455f8d0971a_3";
$secretkey="tIQp4ATe9Z";
$str="ptime=".$ptime."&timeFrame=".$timeFrame."&title=".$title."&vid=".$vid.$secretkey;
//echo $str.'';
$hash=strtoupper(sha1($str));
//echo $hash.'';
$url="http://api.polyv.net/v2/video/{$userid}/clip";
$post_data = array (
    "timeFrame" => $timeFrame,
    "title" => $title,
    "ptime" => $ptime,
    "vid" => $vid,
    "sign" => $hash,
);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
// post数据
curl_setopt($ch, CURLOPT_POST, 1);
// post的变量
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
$output = curl_exec($ch);
curl_close($ch);
//打印获得的数据
print_r($output);
?>

签名规则:

将非空的请求参数按照参数名字典顺序排列,连接参数名与参数值,并在尾部加上secretkey,生成40位大写SHA1值,作为sign。 以下是示例过程:

1、请求参数为

ptime = "1492591990000"
vid = "382839019131be68715e9455f8d0971a_3"
format = "json"

2、将请求参数按照参数名字典顺序排列

format = "json"
ptime = "1492591990000"
vid = "382839019131be68715e9455f8d0971a_3"

3、连接字符串
连接参数名与参数值,并在尾部加上secretkey(secretkey的值为tIQp4ATe9Z),如下:

format=json&ptime=1492591990000&vid=382839019131be68715e9455f8d0971a_3tIQp4ATe9Z

4、生成签名sign

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