编辑单个视频的信息

点击这里查看旧版

接口URL

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

接口说明

(接口调用有频率限制,详细请查看)

编辑用户的某个视频的信息

返回结果支持格式

XML/JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string POLYV用户ID,http://api.polyv.net/v2/data/{userid}/viewlog中的{userid}需要替换为POLYV用户ID的值
describ false string 视频描述
format false string 默认返回json格式,如果format=xml返回xml格式
jsonp false string 例如,正常情况{error:0,data:””},加 jsonp=a后返回a({error:0,data:””})
ptime true string 当前时间的毫秒级时间戳(13位),3分钟内有效
publishUrl false string 视频首发外链地址
tag false string 视频标签
title false string 视频标题
vid true string 视频ID
sign true string 签名,为40位大写的SHA1值

注意事项

sign的拼接规则是:describ=参数&format=参数&jsonp=参数&ptime=参数&publishUrl=参数&tag=参数&title=参数&vid=参数secretkey,再经过SHA-1加密并大写化。
这里要注意,如果这些参数的值为空串,则sign里就不用拼上这些变量

返回结果XML示例

<xml>
    <code>200</code>
    <status>success</status>
    <message>success</message>
    <data>
        <images_b>9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_0_b.jpg</images_b>
        <images_b>9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_1_b.jpg</images_b>
        <images_b>9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_2_b.jpg</images_b>
        <images_b>9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_3_b.jpg</images_b>
        <images_b>9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_4_b.jpg</images_b>
        <images_b>9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_5_b.jpg</images_b>
        <images>9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_0.jpg</images>
        <images>9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_1.jpg</images>
        <images>9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_2.jpg</images>
        <images>9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_3.jpg</images>
        <images>9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_4.jpg</images>
        <images>9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_5.jpg</images>
        <tag>标签</tag>
        <mp4>http://mpv.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_1.mp4</mp4>
        <title>标题</title>
        <df>3</df>
        <times>210</times>
        <vid>9f1e0689e10f2630f8fa8a6a2ae15771_9</vid>
        <mp4_1>http://mpv.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_1.mp4</mp4_1>
        <mp4_2>http://mpv.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_2.mp4</mp4_2>
        <mp4_3>http://mpv.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_3.mp4</mp4_3>
        <cataid>1470638936124</cataid>
        <swf_link>http://player.polyv.net/videos/9f1e0689e10f2630f8fa8a6a2ae15771_9.swf</swf_link>
        <status>60</status>
        <seed>1</seed>
        <flv1>http://plvod01.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_1.plv</flv1>
        <flv2>http://plvod01.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_2.plv</flv2>
        <flv3>http://plvod01.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_3.plv</flv3>
        <sourcefile></sourcefile>
        <playerwidth>600</playerwidth>
        <default_video>http://plvod01.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_3.plv</default_video>
        <duration>00:00:48</duration>
        <first_image>http://img.videocc.net/uimage/9/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_0.jpg</first_image>
        <original_definition>848x480</original_definition>
        <context>描述</context>
        <playerheight>338</playerheight>
        <ptime>2016-11-10 15:49:41</ptime>
        <source_filesize>22666814</source_filesize>
        <filesize>2901272</filesize>
        <filesize>4760736</filesize>
        <filesize>8585884</filesize>
        <md5checksum>49ad17b30692197bc6f63c209462f1ab</md5checksum>
        <hls>http://hls.videocc.net/9f1e0689e1/9/9f1e0689e10f2630f8fa8a6a2ae15771_1.m3u8</hls>
        <hls>http://hls.videocc.net/9f1e0689e1/9/9f1e0689e10f2630f8fa8a6a2ae15771_2.m3u8</hls>
        <hls>http://hls.videocc.net/9f1e0689e1/9/9f1e0689e10f2630f8fa8a6a2ae15771_3.m3u8</hls>
        <uploader> 
            <email>test2@zzs.com</email>  
            <name>test2</name>  
            <role>上传者</role> 
        </uploader>
        <keepsource>0<keepsource/>
        <hlsLevel>open</hlsLevel>
        <cataname>新建分类测试</cataname>
    </data>
</xml>

返回结果JSON示例

{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": [{
        "images_b": [
        "9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_0_b.jpg",
        "9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_1_b.jpg",
        "9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_2_b.jpg",
        "9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_3_b.jpg",
        "9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_4_b.jpg",
        "9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_5_b.jpg"],
        "images": [
        "9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_0.jpg",
        "9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_1.jpg",
        "9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_2.jpg",
        "9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_3.jpg",
        "9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_4.jpg",
        "9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_5.jpg"],
        "tag": "标签",
        "mp4": "http://mpv.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_1.mp4",
        "title": "标题",
        "df": 3,
        "times": "210",
        "vid": "9f1e0689e10f2630f8fa8a6a2ae15771_9",
        "mp4_1": "http://mpv.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_1.mp4",
        "mp4_2": "http://mpv.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_2.mp4",
        "mp4_3": "http://mpv.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_3.mp4",
        "cataid": "1470638936124",
        "swf_link": "http://player.polyv.net/videos/9f1e0689e10f2630f8fa8a6a2ae15771_9.swf",
        "status": "60",
        "seed": 1,
        "flv1": "http://plvod01.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_1.plv",
        "flv2": "http://plvod01.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_2.plv",
        "flv3": "http://plvod01.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_3.plv",
        "sourcefile": "",
        "playerwidth": "600",
        "default_video": "http://plvod01.videocc.net/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_3.plv",
        "duration": "00:00:48",
        "first_image": "http://img.videocc.net/uimage/9/9f1e0689e1/1/9f1e0689e10f2630f8fa8a6a2ae15771_0.jpg",
        "original_definition": "848x480",
        "context": "描述",
        "playerheight": "338",
        "ptime": "2016-11-10 15:49:41",
        "source_filesize": 22666814,
        "filesize": [2901272,4760736,8585884],
        "md5checksum": "49ad17b30692197bc6f63c209462f1ab",
        "hls": [
        "http://hls.videocc.net/9f1e0689e1/9/9f1e0689e10f2630f8fa8a6a2ae15771_1.m3u8",
        "http://hls.videocc.net/9f1e0689e1/9/9f1e0689e10f2630f8fa8a6a2ae15771_2.m3u8",
        "http://hls.videocc.net/9f1e0689e1/9/9f1e0689e10f2630f8fa8a6a2ae15771_3.m3u8"],
        "uploader": {
                "email": "test@zzs.com",
                "name": "cest",
                "role": "上传者"
            },
        "keepsource": "0",
        "cataname": "web加密"
    }]
}

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
images_b 视频截图大图地址
images 视频截图小图地址
tag 视频标签
title 视频标题
df 视频码率数
times 播放次数
vid 视频id
mp4_1 流畅码率mp4格式视频地址
mp4_2 高清码率mp4格式视频地址
mp4_3 超清码率mp4格式视频地址
cataid 分类id, 如1为根目录
swf_link 返回flash连接
status 视频状态:60/61已发布;10等待编码;20正在编码;50等待审核;51审核不通过;-1已删除;
seed 加密视频为1,非加密为0
flv1 流畅码率flv格式视频地址
flv2 高清码率flv格式视频地址
flv3 超清码率flv格式视频地址
sourcefile 源文件
playerwidth 视频宽度
default_video 用户默认播放视频
duration 视频时长
first_image 视频首图
original_definition 最佳分辨率
context 视频描述
playerheight 视频高度
ptime 上传时间
source_filesize 源文件大小
filesize 编码后各个清晰度视频的文件大小,类型为array
md5checksum md5校验值
hls 编码后各个清晰度视频的m3u8地址,类型为array
keepsource 是否为源文件,否:0,是:1
uploader.email 上传者邮箱
uploader.name 上传者名称
uploader.role 上传者角色,如管理员,上传者,主账号
hlsLevel 加密等级 open:非授权加密 web:web授权 app:app授权 wxa_app:小程序授权
cataname 分类名称

PHP示例代码

<?php
header("Content-type:text/html;charset=utf-8");
$userid="7d26575efe";
$ptime=time()*1000;
$secretkey="ABIEn1UJht";
$vid="7d26575efe2d787bed8fffa6b7d01da3_7";
$describ="描述";
$format="json";
$jsonp="a";
$publishUrl="http://www.polyv.net";
$tag="标签";
$title="标题";
$url="http://api.polyv.net/v2/video/$userid/video-info";
$str="describ=".$describ."&format=".$format."&jsonp=".$jsonp."&ptime=".$ptime."&publishUrl=".$publishUrl."&tag=".$tag."&title=".$title."&vid=".$vid.$secretkey;
$sign=strtoupper(sha1($str));
$post_data=array(
   "describ"=>$describ,
   "format"=>$format,
   "jsonp"=>$jsonp,
   "ptime"=>$ptime,
   "publishUrl"=>$publishUrl,
   "tag"=>$tag,
   "title"=>$title,
   "vid"=>$vid,
   "sign"=>$sign
    );
$ch=curl_init();
curl_setopt($ch,CURLOPT_URL,$url);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,1);
curl_setopt($ch,CURLOPT_POST,1);
curl_setopt($ch,CURLOPT_POSTFIELDS,$post_data);
$result=curl_exec($ch);
curl_close($ch);
echo $result;
?>

签名规则:

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

1、请求参数为

describ = "描述"
format = "json"
jsonp = "a"
ptime = "1503287278000"
publishUrl = "http://www.polyv.net"
tag = "标签"
title = "标题"
vid = "7d26575efe2d787bed8fffa6b7d01da3_7"

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

describ = "描述"
format = "json"
jsonp = "a"
ptime = "1503287278000"
publishUrl = "http://www.polyv.net"
tag = "标签"
title = "标题"
vid = "7d26575efe2d787bed8fffa6b7d01da3_7"

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

describ=描述&format=json&jsonp=a&ptime=1503287764000&publishUrl=http://www.polyv.net&tag=标签&title=标题&vid=7d26575efe2d787bed8fffa6b7d01da3_7ABIEn1UJht

4、生成签名sign

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

删除视频

点击这里查看旧版

接口URL

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

接口说明

(接口调用有频率限制,详细请查看)

删除视频

返回结果支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string 用户ID
vid true string 视频ID
sign true string 签名,40位大写的sha1值
ptime true string 当前13位毫秒级时间戳,3分钟内有效
format false string 默认返回json格式,如果format=xml返回xml格式
jsonp false string 例如,正常情况{error:0,data:””},加 jsonp=a后返回a({error:0,data:””})
deleteType false string 删除方式,1:删除到回收站,2:彻底删除,默认为:1

JSON示例

{
code: 200,
status: "success",
message: "success",
data: "删除成功."
}

返回错误json

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

PHP示例代码

<?php
header("Content-type: text/html; charset=utf-8");
$userid="3828390191";
//$jsonp="a";
$ptime=time()*1000;//13位
$vid="3828390191de2b3fd3467c36187aac08_3";
$secretkey="tIQp4ATe9Z";
if(empty($jsonp)){
    $str="ptime=".$ptime."&vid=".$vid.$secretkey;
}else{
    $str="jsonp=".$jsonp."&ptime=".$ptime."&vid=".$vid.$secretkey;
}
echo $str.'';
$hash=strtoupper(sha1($str));
echo $hash.'';
$url="http://api.polyv.net/v2/video/{$userid}/del-video";
$post_data = array (
    //"jsonp" => $jsonp,
    "vid" => $vid,
    "ptime" => $ptime,
    "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" = "1493188350000"
"vid" = "3828390191de2b3fd3467c36187aac08_3"

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

"ptime" = "1493188350000"
"vid" = "3828390191de2b3fd3467c36187aac08_3"

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

ptime=1493188350000&vid=3828390191de2b3fd3467c36187aac08_3tIQp4ATe9Z

4、生成签名sign

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

删除视频的全部打点信息

接口URL

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

接口说明

(接口调用有频率限制,详细请查看)

通过API删除视频的全部视频打点信息

返回结果支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid string 用户ID
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
vid string 视频ID
sign string 签名,为40位大写的SHA1值

JSON示例

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

字段说明

字段 说明
status 成功/失败状态
code 成功/失败代码
message 成功/失败信息
data 成功/失败数据

php请求示例

<?php
  $userid="8f8482aaab";
  $secretkey="AiDQw1mAmi";
  $vid="8f8482aaab8fe7ea12e3314a11a061fc_8";
  $ptime=time()*1000;
  $str="ptime=$ptime&vid=$vid".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/deleteKeyFrame?ptime=$ptime&vid=$vid&sign=$sign";
  $content = file_get_contents($url);
  echo $content;
?>

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign。

以下是示例过程:

1. 将请求参数按照参数名字典顺序排列为:

ptime="1476753635000";
vid="8f8482aaab8fe7ea12e3314a11a061fc_8";

2. 连接字符串 用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign(本示例的值为AiDQw1mAmi),如下:

ptime=1476753635000&vid=8f8482aaab8fe7ea12e3314a11a061fc_8AiDQw1mAmi

3. 生成签名sign

sign为40位大写的SHA1值:

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

设置视频打点

接口URL

http://api.polyv.net/v2/video/{userId}/saveKeyFrame

接口说明

(接口调用有频率限制,详细请查看)

设置视频打点

返回结果支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid string POLYV用户ID,http://api.polyv.net/v2/video/{userId}/saveKeyFrame中的{userid}需要替换为POLYV用户ID的值
vid string 视频的ID
desc string 打点描述,如果上传多个打点用英文逗号","隔开
seconds string 打点秒数【第seconds秒】,如果上传多个打点用英文逗号","隔开
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign string 签名,为40位大写的SHA1值
btnsettingswitch string 按钮设置开关,“Y”为开启, “N”为关闭,不传表示关闭
btndesc string 按钮描述,按钮开关开启时必填,关闭时btndesc不设置
btnhref string 按钮跳转地址,按钮开关开启时必填,关闭时btndesc不设置

注意事项

    seconds(打点秒数【第seconds秒】)必须要小于视频长度;

    dess(打点描述)的个数必须要和seconds的个数相同。

响应参数

参数名 类型 说明
code int 成功/失败代码
status string 成功/失败状态
message string 成功/失败信息
data string 成功响应的数据

JSON示例

{
  code: 200,
  status: "success",
  message: "success",
  data: "the key frame add successfully"
}

php请求示例

<?php
$desc = "第1个打点,第2个打点,第3个打点";
$seconds = "6,16,26";
$userid = "8205ac89d3";
$ptime = time()*1000;
$vid = "8205ac89d3ac2b9a7e72a71d16799803_8";
$secretkey = "kXmHMLeX6M";
$str = "ptime=$ptime"."&userid=$userid"."&vid=$vid".$secretkey;
$sign = strtoupper(sha1($str));
$url = "http://api.polyv.net/v2/video/$userid/saveKeyFrame?ptime=$ptime&desc=$desc&seconds=$seconds&vid=$vid&sign=$sign&";
$content = file_get_contents($url);
echo $content;
?>

签名规则

将请求参数(userid,ptime,vid)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign。

以下是示例过程:

1. 请求参数为:

userid="8205ac89d3"
ptime="1474160490000"
vid="8205ac89d39ad353f0350e5ce73a7244_8"

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

ptime="1474160490000"
userid="8205ac89d3"
vid="8205ac89d39ad353f0350e5ce73a7244_8"

3. 连接字符串

连接参数名与参数值,并在首尾加上secretkey的值(本示例的值为kXmHMLeX6M),如下:

ptime=1474160490000&userid=8205ac89d3&vid=8205ac89d39ad353f0350e5ce73a7244_8kXmHMLeX6M

4. 生成签名sign

sign为40位大写的SHA1值:

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