远程批量上传视频

接口URL

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

接口说明

批量上传远程视频(异步上传)

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
ptime true string 当前13位毫秒级时间戳,3分钟内有效
fileUrl true string 远程文件的http连接(带http://),多个地址间使用英文逗号隔开
title true string 标题,多个标题使用逗号隔开,**标题数量必须和文件地址数量一致 **
cataid false long 设定上传视频的分类,分类的id可以在“视频管理”——“内容分类”中获取,如下图所示。cataid为catatree的最后一个long型的整数,catatree由cataid组成。当cataid值为1时,表示用户上传空间的根目录。
sign true string 签名

JSON示例

{
    code: 200,
    status: "success",
    message: "success",
    data: "成功!"
}

返回错误json

// 文件url不能为空
{
  "code":400,
  "status":"error",
  "message":"FileUrl is null!",
  "data":""
}
// 文件标题不能为空
{
  "code":400,
  "status":"error",
  "message":"Title is null!",
  "data":""
}
// 文件的url个数必须和title个数相同
{
  "code":400,
  "status":"error",
  "message":"FileUrl and title are inconsistent!",
  "data":""
}

PHP示例代码

<?php
  $userid="8205ac89d3";
  $secretkey = "kXmHMLeX6M";
  $ptime=time()*1000;
  $fileUrl="http://a.mp4,http://b.mp4";
  $title="aaa,bbb";
  $cataid="131313";
  $str="cataid=$cataid&fileUrl=$fileUrl&ptime=$ptime&title=$title".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/grab/$userid/upload/multi?cataid=$cataid&fileUrl=$fileUrl&ptime=$ptime&title=$title&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_CUSTOMREQUEST, "POST");
  $output = curl_exec($ch);
  curl_close($ch);
  print_r($output);
?>

签名规则:

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

1、请求参数为

  "cataid"="131313";
  "fileUrl"="http://a.mp4,http://b.mp4";
  "title"="aaa,bbb";
  "ptime"=1527228607000;

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

  "cataid"="131313";
  "fileUrl"="http://a.mp4,http://b.mp4";
  "ptime"=1527228607000;
  "title"="aaa,bbb";

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

cataid=131313&fileUrl=http://a.mp4,http://b.mp4&ptime=1527228607000&title=aaa,bbbkXmHMLeX6M

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

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