获取用户空间及流量情况

接口URL

http://api.polyv.net/v2/user/{userid}/main

接口说明

获取用户空间及流量情况

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid tring POLYV用户ID, http://api.polyv.net/v2/user/{userid}/main中的{userid}需要替换为POLYV用户ID的值
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
date string 要查询的日期,格式 :yyyy-MM-dd
sign string 签名,为40位大写的SHA1值

返回结果

{
code: 200,
status: "success",
message: "",
data: {
    totalFlow: 12884901888,
    usedSpace: 12506060996,
    usedFlow: 5773484280,
    totalSpace: 15032385536,
    userId: "8205ac89d3",
    email: "429525836@qq.com"
   }
}
字段 说明
code 成功/失败代码
status 成功/失败状态
message 成功/失败信息
totalFlow 用户总流量
usedSpace 已用空间
usedFlow 已用流量
totalSpace 用户总空间
userId POLYV用户ID
email POLYV用户邮箱

php请求示例

<?php
$userid = "8205ac89d3";
$ptime = time()*1000;
$date = "2017-08-28";
$secretkey = "kXmHMLeX6M";
$str = "date=$date"."&ptime=$ptime".$secretkey;
$sign = strtoupper(sha1($str));
$url = "http://api.polyv.net/v2/user/$userid/main?ptime=$ptime&sign=$sign&date=$date";
$content = file_get_contents($url);
echo $content;
?>

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写SHA1值,作为sign。

以下是示例过程:

1. 将请求参数按照参数名字典顺序排列为:

date="2017-08-28";
ptime="1470969330000";

2. 连接字符串

用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写SHA1值,作为sign(本示例的值为kXmHMLeX6M),如下:

date=2017-08-28&ptime=1470969330000kXmHMLeX6M

3. 生成签名sign

sign为40位大写SHA1值:DAFD320EC4E2D54E093CBA497ECD30EFB828BFB2

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

获取某一天视频日志

接口URL

http://api.polyv.net/v2/data/{userid}/viewlog

接口说明

获取某一天视频日志

支持格式

JSON

请求方式

POST,GET

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userid string POLYV用户ID,http://api.polyv.net/v2/data/{userid}/viewlog中的{userid}需要替换为POLYV用户ID的值
day string 查询某天的日志时间
ptime string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign string 签名,为40位大写的SHA1值
type string 返回的数据格式为:json/xml
vid string 视频ID

JSON示例

{
  code: 200,
  status: "success",
  message: "",
  data: [
  {
    playId: "1468389486891X1363716",
    userId: "3828390191",
    videoId: "3828390191ed924fbb387395ae6f3af5_3",
    playDuration: 13,
    stayDuration: 17,
    currentTimes: 14,
    duration: 1551,
    flowSize: 13638592,
    sessionId: "",
    param1: "",
    param2: "",
    param3: "",
    param4: "",
    param5: "160712",
    ipAddress: "120.197.57.62",
    country: "中国",
    province: "广东",
    city: "广州",
    isp: "",
    referer: "http://apollo.polyv.net/front/video/preview?vid=3828390191ed924fbb387395ae6f3af5_3",
    userAgent: "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/53.0.2767.5 Safari/537.36",
    operatingSystem: "Windows",
    browser: "Chrome",
    isMobile: "N",
    currentDay: "2016-07-13",
    currentHour: 13,
    createdTime: 1468389527000,
    lastModified: 1468389563000
  }
  ]
}

字段说明

字段 说明
playId 表示此次播放动作的ID
userId 用户ID
videoId 视频ID
playDuration 播放时长 (用户观看的总时间 ,例如:18:00开始看一个视频,看到了18:30,这30分钟就是播放时长)
stayDuration 缓存时长
currentTimes 播放时间 (用户观看的最后时间,例如:停止观看视频的时候,进度条最后的分钟数为35分钟,播放时间就是35分钟)
duration 视频总时长
flowSize 流量大小
sessionId 用户自定义参数,如学员ID等,该参数做了UrlSafeBase64的加密,需要做解密
param1/2/3/4/5 POLYV系统参数
ipAddress IP地址
country 国家
province 省份
city 城市
isp ISP运营商
referer 播放视频页面地址
userAgent 用户设备
operatingSystem 操作系统
browser 浏览器
isMobile 是否为移动端
currentDay 日志查询日期 (格式为:yyyy-MM-dd)
currentHour 日志查看时间
createdTime 播放开始时间 (格式为13位的时间戳)
lastModified 日志更新日期 (格式为13位的时间戳)

php请求示例

<?php
    $userid="e2e84a7383";
    $day="20160711";
    $readtoken="JZmdsRB4sD-OdmDKN2Rnm-bsFGj3Fi93";
    $secretkey="7UagtQOq2A";
    $ptime=time()*1000;
    $str="day=$day&ptime=$ptime&userid=$userid".$secretkey;
    $sign=strtoupper(sha1($str));
    $vid="e2e84a73839a7070861257c3612309e1_e";
    $url="http://api.polyv.net/v2/data/$userid/viewlog?day=$day&ptime=$ptime&sign=$sign&type=json&vid=$vid";
    $content = file_get_contents($url);
    echo $content;
?>

签名规则

将请求参数(sign除外)按照参数名字典顺序排列,用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign。

以下是示例过程:

1. 将请求参数按照参数名字典顺序排列为:

day="20160711";
ptime="1468982782000";
userid="e2e84a7383";

2. 连接字符串 用“&”连接参数名与参数值,并在最后加上secretkey的值,生成40位大写的SHA1值,作为sign(本示例的值为7UagtQOq2A),如下:

day=20160711&ptime=1468982782000&userid=e2e84a73837UagtQOq2A

3. 生成签名sign

sign为40位大写的SHA1值:

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

按标题查找视频(v1.0 版)

searchByTitle

    作用:按视频标题查询视频列表

URL

    http://v.polyv.net/uc/services/rest?method=searchByTitle

支持格式

    XML/JSON
HTTP请求方式
    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型及范围说明
readtokentruestring用户的读取钥匙
keywordtruestring视频标题
numPerPagefalseint页数
pageNumfalseint页码
formatfalsestring默认返回json格式,如果format=xml返回xml格式
jsonpfalsestring 例如,正常情况{error:0,data:””},加 jsonp=a后返回a({error:0,data:””})

注意事项

    返回错误列表
返回说明
0无错误
1找不到writetoken关联的user
2文件为空或者writetoken为空
3提交的json名字JSONRPC为null
4提交文件格式不正确
5readtoken为空
6分页输入出错
7vid不能为空
8找不到方法名

返回结果

<xml>
<error>0</error>
<data>
<video>
<swf_link>"http://v.polyv.net/player/Player.swf?vid=24181d5fd6e44561af9f2062862d5f7f_3"</swf_link>
<duration>""</duration>
<title>"110826每日猛料 实拍最牛国电领导咆哮记者 反对我就是反对党 "</title>
<first_image>"http://v.polyv.net/uimage/3/3BGEYCaPIV/f/24181d5fd6e44561af9f2062862d5f7f_0.jpg"</first_image>
<times>"0"</times>
<tag>"[]"</tag>
<context>""</context>
<ptime>"2011-08-26 17:06:33"</ptime>
<vid>"24181d5fd6e44561af9f2062862d5f7f_3"</vid>
</video>
<video>
<swf_link>"http://v.polyv.net/player/Player.swf?vid=bfbe364c71f63c7069520a827ef3af59_3"</swf_link>
<duration>""</duration>
<title>"实拍车祸现场村民不救人疯狂抢油 1"</title>
<first_image>"http://v.polyv.net/uimage/3/3BGEYCaPIV/9/bfbe364c71f63c7069520a827ef3af59_0.jpg"</first_image>
<times>"0"</times>
<tag>"[]"</tag>
<context>""</context>
<ptime>"2011-08-26 13:03:06"</ptime>
<vid>"bfbe364c71f63c7069520a827ef3af59_3"</vid>
</video>
</data>
</xml>

JSON示例

{"error":"0", "data":
[{
"swf_link":"http://v.polyv.net/player/Player.swf?vid=24181d5fd6e44561af9f2062862d5f7f_3",
"duration":"",
"title":"110826每日猛料 实拍最牛国电领导咆哮记者 反对我就是反对党 - 高清在线观看 - 腾讯视频",
"first_image":"http://v.polyv.net/uimage/3/3BGEYCaPIV/f/24181d5fd6e44561af9f2062862d5f7f_0.jpg",
"times":"0",
"tag":"[]",
"context":"",
"ptime":"2011-08-26 17:06:33",
"vid":"24181d5fd6e44561af9f2062862d5f7f_3"
 },{
"swf_link":"http://v.polyv.net/player/Player.swf?vid=bfbe364c71f63c7069520a827ef3af59_3",
"duration":"",
"title":"实拍车祸现场村民不救人疯狂抢油 - 网易视频 1",
"first_image":"http://v.polyv.net/uimage/3/3BGEYCaPIV/9/bfbe364c71f63c7069520a827ef3af59_0.jpg",
"times":"0",
"tag":"[]",
"context":"",
"ptime":"2011-08-26 13:03:06",
"vid":"bfbe364c71f63c7069520a827ef3af59_3"
}]
}

字段说明

字段说明
error错误提示
swf_link返回flash连接
duration返回时长
title标题
first_image视频图片
times点击次数
tag标签
context内容
ptime上传时间
vid视频id
如果API想调用签名,可参考http://dev.polyv.net/2014/09/23/jsapi0028/ 按参数签名顺序拼凑字符串为keyword=$(keyword)&numPerPage=$(numPerPage)&pageNum=$(pageNum)&readtoken=$(readtoken)$(secretkey),并进行sha1计算,得到sign。
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

按标签查找视频(v1.0 版)

searchByTag

    作用:按视频标签查找视频列表

URL

    http://v.polyv.net/uc/services/rest?method=searchByTag

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型及范围说明
readtokentruestring用户的读取钥匙
tagtruestring视频标签
numPerPagefalseint页数
pageNumfalseint页码
formatfalsestring默认返回json格式,如果format=xml返回xml格式
jsonpfalsestring 例如,正常情况{error:0,data:””},加 jsonp=a后返回a({error:0,data:””})

注意事项

    返回错误列表
返回说明
0无错误
1找不到writetoken关联的user
2文件为空或者writetoken为空
3提交的json名字JSONRPC为null
4提交文件格式不正确
5readtoken为空
6分页输入出错
7vid不能为空
8找不到方法名

返回结果

<xml>
<error>0</error>
<data>
<video>
<swf_link>"http://v.asdtv.com/player/Player.swf?vid=24181d5fd6e44561af9f2062862d5f7f_3"</swf_link>
<duration>""</duration>
<title>"110826每日猛料 实拍最牛国电领导咆哮记者 反对我就是反对党 "</title>
<first_image>"http://v.polyv.net/uimage/3/3BGEYCaPIV/f/24181d5fd6e44561af9f2062862d5f7f_0.jpg"</first_image>
<times>"0"</times>
<tag>"[]"</tag>
<context>""</context>
<ptime>"2011-08-26 17:06:33"</ptime>
<vid>"24181d5fd6e44561af9f2062862d5f7f_3"</vid>
</video>
<video>
<swf_link>"http://v.polyv.net/player/Player.swf?vid=bfbe364c71f63c7069520a827ef3af59_3"</swf_link>
<duration>""</duration>
<title>"实拍车祸现场村民不救人疯狂抢油 1"</title>
<first_image>"http://v.polyv.net/uimage/3/3BGEYCaPIV/9/bfbe364c71f63c7069520a827ef3af59_0.jpg"</first_image>
<times>"0"</times>
<tag>"[]"</tag>
<context>""</context>
<ptime>"2011-08-26 13:03:06"</ptime>
<vid>"bfbe364c71f63c7069520a827ef3af59_3"</vid>
</video>
</data>
</xml>

JSON示例

    {"error":"0", "data":
[{
"swf_link":"http://v.polyv.net/player/Player.swf?vid=24181d5fd6e44561af9f2062862d5f7f_3",
"duration":"",
"title":"110826每日猛料 实拍最牛国电领导咆哮记者 反对我就是反对党 - 高清在线观看 - 腾讯视频",
"first_image":"http://v.polyv.net/uimage/3/3BGEYCaPIV/f/24181d5fd6e44561af9f2062862d5f7f_0.jpg",
"times":"0",
"tag":"[]",
"context":"",
"ptime":"2011-08-26 17:06:33",
"vid":"24181d5fd6e44561af9f2062862d5f7f_3"
 },{
"swf_link":"http://v.polyv.net/player/Player.swf?vid=bfbe364c71f63c7069520a827ef3af59_3",
"duration":"",
"title":"实拍车祸现场村民不救人疯狂抢油 - 网易视频 1",
"first_image":"http://v.polyv.net/uimage/3/3BGEYCaPIV/9/bfbe364c71f63c7069520a827ef3af59_0.jpg",
"times":"0",
"tag":"[]",
"context":"",
"ptime":"2011-08-26 13:03:06",
"vid":"bfbe364c71f63c7069520a827ef3af59_3"
}]
    }

字段说明

字段说明
error错误提示
swf_link返回flash连接
duration返回时长
title标题
first_image视频图片
times点击次数
tag标签
context内容
ptime上传时间
vid视频id
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

查询播放域名限制

getHostUrl

    作用:查询播放域名限制

URL

    http://v.polyv.net/uc/services/rest?method=getHostUrl

支持格式

    JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型及范围说明
readtokentruestring用户的读钥匙
jsonpfalsestring 例如,正常情况{error:0,data:""},加jsonp=a后返回a({error:0,data:""})

注意事项

    返回错误列表

返回说明
0无错误
1找不到writetoken关联的user
2文件为空或者writetoken为空
3提交的json名字JSONRPC为null
4提交文件格式不正确
5readtoken为空
6分页输入出错
7vid不能为空
8找不到方法名

JSON示例

{
error: "0",
Host_setting: {
disable_host: "www.baidu.com,",
enable_host: "www.google.com",
setting_type: 3,
userid: "e2e84a7383"
}
}

字段说明

字段说明
disable_host禁止播放的域名
enable_host允许播放域名
setting_type域名设置类型
0:无域名限制
1:播放器启动禁止域名黑名单
2:播放器启动允许域名白名单
3:启动允许以及禁止播放域 (注:先判断允许播放域,再判断禁止播放域)

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