接口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值 |
| false | string | 子帐号邮箱,默认为查询所有子帐号(不包括主账号) | |
| orderType | false | int | 结果排序类型, 1表示ptime升序，2表示ptime降序，3表示times升序，4表示times降序 |
| cataid | false | long | 分类id,默认为查询所有分类 |
| containSubCata | false | int | 1表示结果包含子分类，0表示结果不包含子分类，默认为0 |
| published | false | int | 1表示结果只包含已发布的视频，0或者不传为包含所有状态的视频 |
| page | false | int | 第几页，默认查询第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...