获取用户下所有播放器列表接口

接口URL

http://api.polyv.net/v2/play/{userid}/player-list

接口说明

获取用户下的播放器列表。

支持格式

JSON

请求方式

GET

请求参数

参数名 必选 类型及范围 说明
userid true string 用户id,路径参数
ptime true string 当前13位毫秒级时间戳,3分钟内有效
sign true string 签名,40位大写的sha1值

返回结果

{
  "code": 200,
  "status": "success",
  "message": "success",
  "data": [
    {
      "playerName": "默认",
      "playerId": "test1",
      "date": "2018-11-15 17:15:29",
      "isDefault": 1
    },
    {
      "playerName": "player2",
      "playerId": "test2",
      "date": "2018-11-15 17:21:07",
      "isDefault": 0
    }
  ]
}

失败返回json

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

字段描述

字段 说明
playerName 播放器名称
playerId 播放器id
date 创建日期
isDefault 是否是默认播放器,是:1, 否:0

响应说明

错误代码 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. 加密串不正确

PHP请求示例

<?php
header("Content-type: text/html; charset=utf-8");
$userid="用户id";
$ptime=time()*1000;//13位
$secretkey="填写secretkey";
$str="ptime=".$ptime.$secretkey;

$hash=strtoupper(sha1($str));
$url="https://api.polyv.net/v2/play/$userid/player-list?ptime=$ptime&sign=$hash";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

$output = curl_exec($ch);
curl_close($ch);
//打印获得的数据
print_r($output);
?>

签名规则:

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

1、请求参数为

ptime = "1492591990000"

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

ptime = "1492591990000"

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

ptime=1492591990000tIQp4ATe9Z

4、生成签名sign

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

视频播放设置

editFlashPlay

    作用:视频播放设置

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型及范围说明
writetokentruestring用户的上传钥匙
vidtruestring视频ID
my_brfalseint码率1.普通,2.清晰3.高清
widthfalseintflash宽度
heightfalseintflash高度
videoautofalseintflash自动播放,1自动播放,0取消自动播放
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>
    <videoplay><height>"300"</height><definition>"1"</definition>    <width>"400"</width><videoauto>"1"</videoauto></videoplay>
    </data>
    </xml>

JSON示例

{"error":"0","data:{"height":"300","definition":"1","width":"400","videoauto":"1"}}

字段说明

字段说明
error错误提示
heightflash高度
definition视频码率
width视频宽度
videoauto是否自动播放

注意事项

该接口对应的是POLYV管理系统中视频设置里面的播放设置板块,需要注意的是,此项设置只对新上传视频有效。

QQ截图20160920182053

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

设置视频的播放器id

changePlayer

    作用:设置视频的播放器id

URL

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

支持格式

    JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型及范围说明
writetokentruestring用户的写钥匙
vidtruestring视频的id
playeridtruestring播放器的id,在POLYV后台——播放器设置界面上可以找到;当playerid的值为其他非法值时,视频的播放器id则会设置为默认播放器的id
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"
}
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...