获取某分类下某子账号的视频列表

接口URL

http://api.polyv.net/v2/video/{userid}/get-by-uploader

接口说明

查询某个子帐号上传到某个分类的视频列表

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值
email false string 子帐号邮箱,默认为查询所有子帐号(不包括主账号)
orderType false int 结果排序类型, 1表示ptime升序,2表示ptime降序,3表示times升序,4表示times降序
cataid false string 分类id,默认为查询所有分类
containSubCata false int 1表示结果包含子分类,0表示结果不包含子分类,默认为0
page false string 第几页,默认查询第1页

返回结果

{
  "code": 200, 
  "status": "success", 
  "message": "success", 
  "data": {
    "pageSize": 20, 
    "pageNumber": 1, 
    "totalItems": 2, 
    "contents": [
      {
        "vid": "b0f7041324d864436f410f581444542a_b", 
        "cataid": 1, 
        "title": "test", 
        "context": "dasdasdadasd", 
        "times": 0, 
        "firstImage": "http://img.videocc.net/uimage/b/b0f7041324/a/b0f7041324d864436f410f581444542a_b.jpg", 
        "tag": "1", 
        "aacLink": null, 
        "status": "61", 
        "uploaderEmail": "test1@zzs.com", 
        "ptime": 1540780829403
      }, 
      {
        "vid": "b0f70413248dbeccef72d9f244278fe1_b", 
        "cataid": 1539918907896, 
        "title": "test", 
        "context": "简介", 
        "times": 0, 
        "firstImage": "http://img.videocc.net/uimage/b/b0f7041324/1/b0f7041324d864436f410f581444542a_b.jpg", 
        "tag": "标签", 
        "aacLink": null, 
        "status": "61", 
        "uploaderEmail": "test1@zzs.com", 
        "ptime": 1540797491063
      }
    ]
  }
}

失败返回json(不带jsonp)

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

字段描述

字段名称 描述
vid 视频vid
cataid 分类id
title 视频标题
context 视频简介
times 播放次数
firstImage 视频首图,封面
tag 标签,以英文逗号(,)分割,没有标签时返回空串
aacLink 音频地址
status 视频状态码
uploaderEmail 子账号邮箱
ptime 上传时间
视频状态码 含义
60/61 已发布
10 等待编码
20 正在编码
50 等待审核
51 审核不通过
-1 已删除

响应说明

响应代码 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 cata is not exist. 分类不存在
400 child user not exist. 子账号不存在
500 query failed. 后台程序抛异常
200 success 提交成功

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="用户id";
$secretkey="用户secretkey";

$params = array(
    'ptime' => time()*1000,
    'email' => 'test1@zzs.com',
    'cataid' => '1'
);

# 创建排序后的字典
foreach ($params as $key=>$value){
    $arr[$key] = $key;
}
sort($arr);
$str='';
$length=count($arr);
foreach ($arr as $k => $v) {
    $str = $str.$v.'='.$params[$v];
    if($k < $length-1) {
      $str = $str.'&';
    }
}
$hash=strtoupper(sha1($str.$secretkey));

$params['sign']=$hash;
$url="http://api.polyv.net/v2/video/${userid}/get-by-uploader?".http_build_query($params);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
#curl_setopt($ch, CURLOPT_POST, 1);
$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...