恢复回收站视频API接口

接口URL

https://api.polyv.net/v2/video/{userId}/recover-videos

接口说明

该接口恢复点播回收站中的视频,接口支持批量恢复,一次性最多支持恢复100个视频。

支持格式

JSON

请求方式

POST

请求参数

参数名 必选 类型及范围 说明
userId true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
vids true string 点播视频vid

返回结果

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

失败返回json

// 时间戳过期:
{
  "code": 400,
  "status": "error",
  "message": "ptime is too old.",
  "data": ""
}
// 视频vids为空
{
    "code": 400,
    "status": "error",
    "message": "vids can't be empty",
    "data": ""
}
// vids数量超过100个
{
    "code": 400,
    "status": "error",
    "message": "vids limits 100",
    "data": ""
}
// 签名报错
{
    "code": 400,
    "status": "error",
    "message": "the sign is not right.",
    "data": ""
}

响应参数说明

字段 说明 类型 schema
code 响应码 int32
status 响应状态:success/error/fail string
message 错误信息说明 string
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. 签名不正确
400 vids can't be empty 视频vid为空
400 vids limits 100 vids数量超过100个

PHP请求示例

<?php

$userId="xxxxxx";
$secretkey="xxxxxx";
$url = 'http://api.polyv.net/v2/video/'.$userId.'/recover-videos';
$header = array('application/x-www-form-urlencoded');
$data = array(
    "ptime" => time()*1000,
    "vids" => "xxxxxx_x",
);
ksort($data);
$str='';
foreach ($data as $k => $v) {
    $str = $str.$k.'='.$v.'&';
}
$str=substr($str,0,strlen($str)-1);
$str=$str.$secretkey;
$hash=strtoupper(sha1($str));
$data["sign"]=$hash;
// 请求接口
$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$sResult = curl_exec($ch);
if($sError=curl_error($ch)){
    die($sError);
}
curl_close($ch);
//打印获得的数据
print_r($sResult);
?>

签名规则:

将非空的请求参数按照参数名字典顺序排列,连接参数名与参数值,并在尾部加上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...

设置视频的播放预览时长

接口URL

http://api.polyv.net/v2/video/{userid}/set-preview-duration

接口说明

通过API设置视频的播放预览时长

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

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

JSON示例

{
  code: 200,
  status: "success",
  message: "success",
  data: "设置成功."
}
{
  code: 400,
  status: "success",
  message: "success",
  data: "修改的视频不存在."
}

字段说明

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

php请求示例

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

签名规则

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

以下是示例过程:

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

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

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

duration=10&ptime=1476753635000&vid=8f8482aaab8fe7ea12e3314a11a061fc_8AiDQw1mAmi

3. 生成签名sign

sign为40位大写的SHA1值:

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

删除视频指定时间点的打点信息

接口URL

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

接口说明

通过API删除视频的指定时间点的打点信息

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid string 用户ID
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
vid string 视频ID
times string 时间点(单位是秒),可以多个。多个的话用逗号隔开,例如:20,30,50
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";
  $times="10,30,49,60";
  $ptime=time()*1000;
  $str="ptime=$ptime&times=$times&vid=$vid".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/deleteKeyFrameByTime?ptime=$ptime&times=$times&vid=$vid&sign=$sign";
  $content = file_get_contents($url);
  echo $content;
?>

签名规则

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

以下是示例过程:

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

ptime="1476753635000";
times="10,20,30";
vid="8f8482aaab8fe7ea12e3314a11a061fc_8";

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

ptime=1476753635000&times=10,20,30&vid=8f8482aaab8fe7ea12e3314a11a061fc_8AiDQw1mAmi

3. 生成签名sign

sign为40位大写的SHA1值:

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

合并视频

接口URL

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

接口说明

合并视频。

支持格式

JSON

请求方式

POST

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
vids true string 视频id,用逗号隔开,只支持合并2个或者3个
title false string 视频标题,默认为“合并-”+第一个视频的标题。标题长度超过128会被截取
cataId false long 分类id,默认为默认分类
luping false int 是否开启录屏优化,1表示开启,0表示关闭,默认为关闭

返回结果

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

失败返回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 illegal videos' count, count=5 视频数量不合法
412 illegal vid, vid=出错的vid 视频不属于用户本身
413 swf video is not support, vid=出错的vid 不支持swf格式
414 illegal vid. vid=出错的vid 视频不存在或者最高码率还没转码完成
415 category no exists, cataid=出错的cataid 查不到分类
416 keepsource category is not support, cataid=出错的cataid 不支持源文件播放属性的分类
417 concat video failed. backed error=xx 后台处理失败
500 failed. 后台异常

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="用户id";
$vids="视频id1,视频id2";
$ptime=time()*1000;//13位
$secretkey="填写secretkey";
$str="ptime=".$ptime."&vids=".$vids.$secretkey;

$hash=strtoupper(sha1($str));
$url="https://api.polyv.net/v2/video/$userid/concat?ptime=$ptime&sign=$hash&vids=$vids";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$output = curl_exec($ch);
curl_close($ch);
//打印获得的数据
print_r($output);
?>

签名规则:

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

1、请求参数为

ptime = "1492591990000"
vids = "8205ac89d30adeb51a6f8bf1a1df6f63_8,8205ac89d30adeb51a6f8bf1a1df6f63_8"

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

ptime = "1492591990000"
vids = "8205ac89d30adeb51a6f8bf1a1df6f63_8,8205ac89d30adeb51a6f8bf1a1df6f63_8"

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

ptime=1492591990000&vids=8205ac89d30adeb51a6f8bf1a1df6f63_8,8205ac89d30adeb51a6f8bf1a1df6f63_8tIQp4ATe9Z

4、生成签名sign

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

提交视频裁剪任务

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

根据vid批量修改视频的授权播放开关状态

接口URL

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

接口说明

根据vid设置单个视频/多个视频的授权播放开关状态

支持格式

JSON

请求方式

POST

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前时间的毫秒级时间戳(13位),30分钟内有效
userid true string 用户id(拼接在url,无需另外传参数)
sign true string 签名
vids true string 多个视频id,用英文逗号隔开
playauth false number 是否开启,默认为开启

注意事项

所有有值的参数,按照字母排序方式以key=value&key=value的格式串起来,最后拼上secretkey,以SHA-1方式加密并全部大写化。(注意,当参数没有传递,或者传递了空值,sign不需要将此参数计算进去)

例如:api传递了ptime,vid。ptime为1,vid为test1,userid对应用户的secretkey为test2
则sign的值为:ptime=1&vid=test1test2经过SHA-1加密后大写化为: C2B1558D697EA3AF4ED2FC90152751860C1E2163。

返回错误结果JSON示例

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

返回正确结果JSON示例

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

返回结果data表示成功修改的数量.

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
data 操作结果

响应代码与响应信息对应

code message 说明
400 sign can not be empty.
400 ptime is too old.
400 ptime is illegal. ptime超出当前时间3分钟
400 Could not find user by userid.
400 the sign is not right.
401 vids为空.
500 修改失败,请查看后台日志. 后台抛异常
200 success. 修改成功

PHP示例代码

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

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

"playauth" = 1
"ptime" = "1493188350000"
"vids" = "3828390191de2b3fd3467c36187aac08_3,3828390191de2b3fd3467c36187aa111_3"

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

playauth=1&ptime=1493188350000&vids=3828390191de2b3fd3467c36187aac08_3,3828390191de2b3fd3467c36187aa111_3tIQp4ATe9Z

4、生成签名sign

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

删除视频问答条目接口

接口URL

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

接口说明

删除视频的问答题目

支持格式

JSON

HTTP请求方式

POST, GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string 用户ID
examId 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:””})

JSON示例

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

返回错误json

{
  "code":400,
  "status":"error",
  "message":"sign can not be empty.",
  "data":""
}
{
  "code":400,
  "status":"error",
  "message":"vid不能为空。",
  "data":""
}
{
  "code":400,
  "status":"error",
  "message":"examId不能为空。",
  "data":""
}
{
  "code":400,
  "status":"error",
  "message":"该问答条目不存在。",
  "data":""
}
{
  "code":400,
  "status":"error",
  "message":"不允许删除该问答条目。",
  "data":""
}

字段说明

字段 说明
data success表示删除成功

PHP示例代码

<?php
  $userid="2d939377c2";
  $vid="2d939377c23a37d2b0a2428006755627_2";
  $examId="14fedbf06a4";
  $ptime=time()*1000;
  $secretkey="3OmoLbTlHu";
  $str="examId=$examId&ptime=$ptime&vid=$vid".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/del-video-exam?examId=$examId&ptime=$ptime&sign=$sign&vid=$vid";
  $content = file_get_contents($url);
  echo $content;
?>

签名规则:

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

1、请求参数为

"examId" = "14fedbf06a4"
"ptime" = "1493188350000"
"vid" = "3828390191de2b3fd3467c36187aac08_3"

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

"examId" = "14fedbf06a4"
"ptime" = "1493188350000"
"vid" = "3828390191de2b3fd3467c36187aac08_3"

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

examId=14fedbf06a4&ptime=1493188350000&vid=3828390191de2b3fd3467c36187aac08_3tIQp4ATe9Z

4、生成签名sign

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

批量修改视频的授权方式

接口URL

http://api.polyv.net/v2/config/{userid}/hlslevel

接口说明

通过vids批量修改视频的授权方式。

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid string 用户ID
hlslevel string 加密授权参数,值为open/web/app/wxa_app之一,open为开放授权,web为WEB授权,app为APP授权,wxa_app为小程序授权
ptime string 13位当前时间毫秒级时间戳
vids string 多个视频的vid,用英文逗号隔开
sign string 签名,40位大写的sha1值

响应成功JSON****示例:

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

响应失败JSON****示例:

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

字段说明

参数名 说明
code 返回状态码
status 返回状态值
message 返回信息
data 返回数据

php请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="7d26575efe";
$hlslevel= "web";  //值为open/web/app之一
$vids = "7d26575efe9eef80bafa426ff6dd7dc4_7,7d26575efebc3f04e1632fee60d34972_7";
$ptime= time()*1000;
$secretkey = "ABIEn1UJht";

$str = "hlslevel=$hlslevel&ptime=$ptime&vids=$vids".$secretkey;
$sign = strtoupper(sha1($str));

$url="http://api.polyv.net/v2/config/{$userid}/hlslevel";
$post_data = array (
"hlslevel" => $hlslevel,
"ptime" => $ptime,
"vids" => $vids,
"sign" => $sign,
);
$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);
?>

签名规则:

sign生成示例: 

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

hlslevel = "web"
ptime = "1500950616000"
vids = "7d26575efe9eef80bafa426ff6dd7dc4_7,7d26575efebc3f04e1632fee60d34972_7"

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

hlslevel=web&ptime=1500950616000&vids=7d26575efe9eef80bafa426ff6dd7dc4_7,7d26575efebc3f04e1632fee60d34972_7ABIEn1UJht

3、sign为40位大写的SHA1值

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

删除单个视频的问答题目

接口URL

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

接口说明

删除单个视频的问答题目

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userId true string 用户ID
ptime true string 当前13位毫秒级时间戳,3分钟内有效
vid true string 视频ID
sign true string 签名,40位大写的sha1值

JSON示例

正确返回

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

错误返回

{
    code: 400,
    status: "error",
    message: "the sign is not right",
    data: ""
}

PHP示例代码

<?php
header("Content-type: text/html; charset=utf-8");
$userId="7d26575efe";
$ptime=time()*1000;//13位毫秒级时间戳
$vid="7d26575efe5902f5db2f9e5feea17bd7_7";
$secretkey="ABIEn1UJht";
$str="ptime=$ptime&vid=$vid".$secretkey;
$sign=strtoupper(sha1($str));
$url="api.polyv.net/v2/video/$userId/deleteExam?ptime=$ptime&vid=$vid&sign=$sign";
$ch=curl_init();
curl_setopt($ch,CURLOPT_URL,$url);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,1);
$result=curl_exec($ch);
curl_close($ch);
echo $result;
?>

签名规则:

将非空的请求参数按照参数名字典顺序排列,连接参数名与参数值,并在尾部加上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}/video-setting-save

接口说明

修改视频密码

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string POLYV用户ID,http://api.polyv.net/v2/data/{userid}/viewlog中的{userid}需要替换为POLYV用户ID的值
describ false string 视频描述
password false string 视频密码
ptime true string 当前时间的毫秒级时间戳(13位),3分钟内有效
publishUrl false string 首发外链
tag false string 视频标签
title false string 视频标题
vids true string 视频ID
sign true string 签名,为40位大写的SHA1值

注意事项

sign的拼接规则是:describ=参数&password=参数&ptime=参数&publishUrl=参数&tag=参数&title=参数&vids=参数secretkey,再经过SHA-1加密并大写化。

这里要注意,如果这些参数的值为空串,则sign里就不用拼上这些变量

 

PHP示例代码

<?php
$userid="9f1e0689e1";
$describ="描述";
$password="123456";
$ptime=time()*1000;//13位
$publishUrl="my.polyv.net";
$tag="标签";
$title="标题";
$vids="9f1e0689e10f2630f8fa8a6a2ae15771_9";
$post_data = array (
    "describ" => $describ,
    "password" => $password,
    "ptime" => $ptime,
    "publishUrl" => $publishUrl,
    "tag" => $tag,
    "title" => $title,
    "vids" => $vids
);
$str="";
foreach ($post_data as $key => $value){
    // 这里要注意,如果这些参数的值为空串,则sign里就不用拼上这些变量
    if (!empty($value)) {
        $str.=$key."=".$value."&";
    }else{
        unset($post_data[$key]); 
    }
}
$str=substr($str, 0,strlen($str)-1);
$secretkey="AkDipaULWw";
$str.=$secretkey;
// echo $str;
// exit();
$hash=strtoupper(sha1($str));
$post_data["sign"] = $hash;
// var_dump($post_data);
// exit();
$url="http://api.polyv.net/v2/video/{$userid}/video-setting-save";
$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);
$output = curl_exec($ch);
curl_close($ch);
print_r($output);
?>

返回结果

正确返回

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

错误返回

{"code":400,"status":"error","message":"the sign is not right.","data":""}

字段说明

字段 说明
code 返回状态码
status 返回状态值
message 返回信息
data 返回数据
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...