移动视频分类接口

接口URL

http://api.polyv.net/v2/cata/{userid}/change

接口说明

移动视频分类

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string POLYV用户ID
cataid true string 需要移动的目录分类id, (id=1,表示默认分类)
destCataid true string 移动到的目录分类id, (id=1,表示默认分类)
ptime true string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign true string 签名,为40位大写的SHA1值

注意事项

sign的拼接规则是:cataid=参数&destCataid=参数&ptime=参数secretkey,再经过SHA-1加密并大写化。
这里要注意,如果这些参数的值为空串,则sign里就不用拼上这些变量

PHP示例代码

<?php
header("Content-type: text/html; charset=utf-8");
$userid="XXXXXXXX"; //用户id
$ptime= time()*1000;  //获取当前时间戳
$secretkey = "XXXXXXXX"; //用户对应的secretkey
$cataid = "XXXXXXXXX"; //分类id
$destCataid = "XXXXXXXXX"; //移动到的分类id
$str="cataid=".$cataid."&ptime=".$ptime."&userid=".$userid.$secretkey;
$sign = strtoupper(sha1($str));
$url="http://api.polyv.net/v2/cata/$userid/change?destCataid=$destCataid&cataid=$cataid&sign=$sign&ptime=$ptime";
$ch = curl_init() or die ( curl_error() );
curl_setopt( $ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT, 360);
$response = curl_exec ( $ch );
curl_close ( $ch );
echo $response;
?>

返回正确结果JSON示例

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

返回错误结果JSON示例

{
  "code": 400,
  "status": "error",
  "message": "ptime is too old.",
  "data": ""
}
{
  "code": 400,
  "status": "error",
  "message": "cataid为空.",
  "data": ""
}
{
  "code": 402,
  "status": "error",
  "message": "cataid格式出错.",
  "data": ""
}
{
  "code": 402,
  "status": "error",
  "message": "两个cataid不能相同.",
  "data": ""
}
{
  "code": 402,
  "status": "error",
  "message": "不能移动到自己的父亲节点.",
  "data": ""
}

字段说明

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