新建视频分类

点击这里查看旧版

接口URL

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

接口说明

新建视频分类

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string 用户ID(在post的时候不需要提交,只用在接口的url中)
cataname true string 分类名称
catatype false string 分类类型
cataurl false string 分类链接
parentid true string 新建的分类目录的上一级目录,值为1时表示根目录
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
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: {
    catatree: "1,1493347765680",
    cataid: 1493347765680
  }
}

返回错误json

{
  "code":400,
  "status":"error",
  "message":"sign can not be empty.",
  "data":""
}

PHP示例代码

<?php
  $userid="2d939377c2";
  $cataname="新建分类测试";
  $catatype="0";
  $cataurl="分类链接";
  $parentid="1";
  $ptime=time()*1000;
  $secretkey="3OmoLbTlHu";
  $str="cataname=$cataname&catatype=$catatype&cataurl=$cataurl&parentid=$parentid&ptime=$ptime".$secretkey;
  $sign=strtoupper(sha1($str));
  $url="http://api.polyv.net/v2/video/$userid/addCata";
  $post_data = array (
   "cataname" => $cataname,
   "catatype" => $catatype,
   "cataurl" => $cataurl,
   "parentid" => $parentid,
   "ptime" => $ptime,
   "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);
  $output = curl_exec($ch);
  curl_close($ch);
  print_r($output);
?>

签名规则:

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

1、请求参数为

"cataname" = "新建分类测试"
"catatype" = "0"
"cataurl" = "分类链接"
"parentid" = "1"
"ptime" = "1493370776000"

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

"cataname" = "新建分类测试"
"catatype" = "0"
"cataurl" = "分类链接"
"parentid" = "1"
"ptime" = "1493370776000"

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

cataname=新建分类测试&catatype=0&cataurl=分类链接&parentid=1&ptime=14933707760003OmoLbTlHu

4、生成签名sign

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