编辑单个视频的信息

点击这里查看旧版

接口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>
    </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"]
    }]
}

字段说明

字段 说明
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

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...