接口URL

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

接口说明

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

删除抓取视频任务

返回结果支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名	必选	类型及范围	说明
ptime	true	string	当前13位毫秒级时间戳，3分钟内有效
sign	true	string	签名，40位大写的sha1值
taskId	true	string	抓取任务ID

JSON示例

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

返回错误json

{
  "code":400,
  "status":"error",
  "message":"TaskId is null!",
  "data":""
}

PHP示例代码

<?php
  $userid="8205ac89d3";
  $secretkey = "kXmHMLeX6M";
  $ptime=time()*1000;
  $taskId="o0IdvYDm4S";
  $str="ptime=$ptime&taskId=$taskId".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/grab/$userid/delete?ptime=$ptime&sign=$sign&taskId=$taskId";
  $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_CUSTOMREQUEST, "POST");
  $output = curl_exec($ch);
  curl_close($ch);
  print_r($output);
?>

签名规则：

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

1、请求参数为

  "ptime"=1527228607000;
  "taskId"="o0IdvYDm4S";

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

  "ptime"=1527228607000;
  "taskId"="o0IdvYDm4S";

3、连接字符串
连接参数名与参数值,并在尾部加上secretkey（此处secretkey的值为kXmHMLeX6M），如下：

ptime=1527228607000&taskId=o0IdvYDm4SkXmHMLeX6M

4、生成签名sign
生成40位大写SHA1值

37D4F7BC82B927B14DFDD3D71FA8D4675A6FE2A0

接口URL

http://api.polyv.net/v2/video/grab/{userid}/listVideos/export

接口说明

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

导出抓取任务列表的csv文件

请求方式

GET

请求数限制

TRUE

请求参数

参数名	必选	类型及范围	说明
ptime	true	string	当前13位毫秒级时间戳，3分钟内有效
sign	true	string	签名，40位大写的sha1值
taskId	true	string	抓取任务ID

返回说明

错误返回json信息 contentType="application/json;charset=UTF-8"

成功返回csv文件
contentType="text/csv;charset=UTF-8"

返回错误json

{
  "code":400,
  "status":"error",
  "message":"TaskId is null!",
  "data":""
}

PHP示例代码

<?php
  $userid="8205ac89d3";
  $secretkey = "kXmHMLeX6M";
  $ptime=time()*1000;
  $taskId="hHepZ2SjlE";
  $str = "ptime=$ptime&taskId=$taskId".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/grab/$userid/listVideos/export?ptime=$ptime&sign=$sign&taskId=$taskId";
  echo "<script>location.href='$url'</script>";
?>

签名规则：

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

1、请求参数为

  "ptime"=1527228607000;
  "taskId"="o0IdvYDm4S";

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

  "ptime"=1527228607000;
  "taskId"="o0IdvYDm4S";

3、连接字符串
连接参数名与参数值,并在尾部加上secretkey（此处secretkey的值为kXmHMLeX6M），如下：

ptime=1527228607000&taskId=o0IdvYDm4SkXmHMLeX6M

4、生成签名sign
生成40位大写SHA1值

37D4F7BC82B927B14DFDD3D71FA8D4675A6FE2A0

接口URL

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

接口说明

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

分页获取抓取任务列表

返回结果支持格式

JSON

请求方式

GET

请求数限制

TRUE

请求参数

参数名	必选	类型及范围	说明
ptime	true	string	当前13位毫秒级时间戳，3分钟内有效
sign	true	string	签名，40位大写的sha1值
page	true	int	页数，默认为1
pageSize	true	int	每页数目，默认为10

JSON示例

{
code: 200,
status: "success",
message: "",
data: {
pageNumber: 1,
totalItems: 1,
contents: [
{
taskid: "hHepZ2SjlE",
userid: "8205ac89d3",
filename: null,
originalname: "111.csv",
filesize: null,
filepath: null,
fileurl: "http://grab.polyv.net/files/csv/1522286666296.csv",
classifyid: "1",
classifyname: "视频分类(根目录)",
seccesscount: 2,
totalcount: 2,
failcount: 0,
status: "Y",
endtime: 1522286706000,
createtime: 1522286672000
}
],
startRow: 1,
endRow: 1,
firstPage: true,
lastPage: true,
nextPageNumber: 1,
prePageNumber: 1,
totalPages: 1,
limit: 1,
offset: 0
}
}

返回错误json

{
  "code":400,
  "status":"error",
  "message":"TaskId is null!",
  "data":""
}

字段说明

字段	说明
code	返回码
status	返回状态
message	返回信息
data	响应结果集
pageNumber	当前的页数
totalItems	总的条数
contents	查询的结果列表
taskid	抓取任务对应的ID
userid	点播用户的ID
originalname	上传的抓取任务csv文件的标题
fileurl	抓取任务的csv文件地址
seccesscount	抓取成功的数量
totalcount	此任务内总抓取数
failcount	抓取失败的数量
status	抓取任务完成状态
endtime	任务完成时间
createtime	任务创建时间
firstPage	是否为第一页，值为：true/false
lastPage	是否为最后一页，值为：true/false
nextPageNumber	下一页编号
prePageNumber	上一页编号
totalPages	总页数
startRow	当前页第一条记录在总抓取记录中的位置
endRow	当前页最后一条记录在总抓取记录中的位置
limit	当前页抓取任务记录个数

PHP示例代码

<?php
  $userid="8205ac89d3";
  $secretkey = "kXmHMLeX6M";
  $ptime=time()*1000;
  $page=1;
  $str= "page=$page&ptime=$ptime".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/grab/$userid/list?ptime=$ptime&sign=$sign&page=$page";
  $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_CUSTOMREQUEST, "GET");
  $output = curl_exec($ch);
  curl_close($ch);
  print_r($output);
?>

签名规则：

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

1、请求参数为

  "page" = 1;
  "ptime"=1527231353000;

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

  "page" = 1;
  "ptime"=1527231353000;

3、连接字符串
连接参数名与参数值,并在尾部加上secretkey（此处secretkey的值为kXmHMLeX6M），如下：

page=1&ptime=1527231353000kXmHMLeX6M

4、生成签名sign
生成40位大写SHA1值

1C4ADD2222714FC08584853DC22C8F66AD998BED