创建 Playsafe Token (v2)

接口URL

https://hls.videocc.net/service/v2/token/create-child

接口说明

  1. 用于创建 Playsafe Token,这个 token 即是加密视频的播放凭证
  2. 如果一个token尚未过期,此时使用相同的 videoId、viewerId、viewerIp、iswxa 参数值请求该接口,则会复用原来的token,并延长原token的有效期。
  3. 该接口目前仅支持子账号。如果要为主帐户创建 token ,可参考 创建 Playsafe Token

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
appId string 子账号 appId
videoId string 视频ID,例如 e6b23c6f519c5906e54a13b8200d7bb0_e
ts long 当前13位毫秒级时间戳,10分钟内有效
viewerId string 观看者ID,要求不同的观看者使用不同的ID
viewerIp string 观看者IP,如果为空,会自动获取调用该接口时的IP
viewerName string 观看者名称
expires long token 有效时长,单位为秒。为空时默认为10分钟。
disposable boolean true 表示 token 仅一次有效(验证一次后,token 就失效了)。
false 则表示在有效期内可以多次验证。默认为 false。
iswxa int 是否微信小程序播放,1为是,0为否。默认为0。
extraParams string 自定义的其它参数
sign string 签名,为32位大写的MD5值,详细的签名规则见下文

响应成功JSON示例:

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "token": "d8835d53-71f5-40a2-a367-ddb8f8c7f16e-bsbcocx_bk",
        "userId": "e6b23c6f51",
        "appId": "asRocmWigR",
        "videoId": "e6b23c6f51c4b1cb9f0302a92ed42440_e",
        "viewerIp": "127.0.0.1",
        "viewerId": "abcd1234",
        "viewerName": null,
        "extraParams": null,
        "ttl": 600000,
        "createdTime": 1552446282044,
        "expiredTime": 1552446882044,
        "iswxa": 0,
        "disposable": false
    }
}

响应失败JSON示例:

appId 错误

{
    "code": 400,
    "status": "error",
    "message": "user_not_found",
    "data": "user secretKey not found."
}

子账号角色错误(目前仅支持“内容分发”角色)

{
    "code": 400,
    "status": "error",
    "message": "user_children_level_error",
    "data": "user children level error."
}

子账号已过期

{
    "code": 400,
    "status": "error",
    "message": "user_children_expired",
    "data": "user children expired."
}

ts 过期

{
    "code": 403,
    "status": "error",
    "message": "ts_expired",
    "data": "ts parameter is expired."
}

签名错误

{
    "code": 403,
    "status": "error",
    "message": "sign_invalid",
    "data": "sign parameter invalid."
}

响应字段说明

参数名 说明
code 响应代码,200为成功,403为ts过期或签名错误,400为参数错误(例如缺少 userId 或 videoId)
status 成功为success,失败为error
message 成功时为空错误时为错误提示消息
data 成功时为token相关数据,失败时为具体的错误提示
userId 用户ID
appId 子账号ID
videoId 视频ID,例如 e6b23c6f519c5906e54a13b8200d7bb0_e
viewerIp 观看者IP,如果为空,或自动获取调用该接口时的IP
viewerId 观看者ID,要求不同的观看者使用不同的ID
viewerName 观看者名称
extraParams 自定义的其它参数
ttl token 有效时长,单位为毫秒
createdTime token 创建时间
expiredTime token 过期时间
iswxa 是否微信小程序播放,1为是,0为否。
disposable true 表示 token 仅一次有效(验证一次后,token 就失效了)。false 则表示在有效期内可以多次验证。

签名规则

  1. 将除了 sign 之外的全部 非空 请求参数(也就是说,参数值为空的参数,将排除掉,不参与签名的计算),按字典序升序排列,按“参数名1参数值1参数名2参数值2……”的格式拼接起来,例如:ts1552447784505userIde6b23c6f51videoIde6b23c6f51c4b1cb9f0302a92ed42440_eviewerIdabcd1234viewerIp127.0.0.1
  2. 在上述字符串的头、尾分别加上 secretKey。以上述字符串、secretKey为abc为例,得到:abcts1552447784505userIde6b23c6f51videoIde6b23c6f51c4b1cb9f0302a92ed42440_eviewerIdabcd1234viewerIp127.0.0.1abc
  3. 计算上述字符串的MD5值,并转为大写,得到:166D45560D37DDBF0F05081D975231B5

php请求示例

// php
function get_client_ip() {
  if (!empty($_SERVER['HTTP_CLIENT_IP'])) {
    $ipaddress = $_SERVER['HTTP_CLIENT_IP'];
  } elseif (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
      $ipaddress = $_SERVER['HTTP_X_FORWARDED_FOR'];
  } else {
      $ipaddress = $_SERVER['REMOTE_ADDR'];
  }
    return $ipaddress;
}

$appId = 'your appId';       // polyv 提供的 appId
$secretkey = 'your secretkey';     // polyv 提供的接口调用签名访问的key
$videoId = '65956867df8c717eb79136e05394122c_6';  // 视频对应vid
$ts = time() * 1000;      // 时间戳
$viewerIp = get_client_ip();  // 用户 ip
$viewerId = get_viewer_id();      // 自定义用户 id
$viewerName = get_viewer_name();  // 用户昵称, 若值为中文需要urlencode('张三'),可为空
$extraParams = get_extra_params();  // 自定义参数,可为空

/* 将参数 $appId、$secretkey、$videoId、$ts、$viewerIp、$viewerIp、$viewerId、$viewerName、$extraParams
    按照ASCKII升序 key + value + key + value ... +value 拼接
*/
$concated =  'appId'.$appId.'extraParams'.$extraParams.'ts'.$ts.'videoId'.$videoId.'viewerId'.$viewerId.'viewerIp'.$viewerIp.'viewerName'.$viewerName;

// 再首尾加上 secretkey
$plain = $secretkey.$concated.$secretkey;

// 取大写MD5
$sign = strtoupper(md5($plain));



// 然后将下列参数用post请求  https://hls.videocc.net/service/v2/token/create-child 获取 token
$url = 'https://hls.videocc.net/service/v2/token/create-child';
$data = array('appId' => $appId, 'videoId' => $videoId, 'ts' => $ts, 'viewerIp' => $viewerIp, 'viewerName' => $viewerName, 'extraParams' => $extraParams, 'viewerId' => $viewerId, 'sign' => $sign);

$options = array(
    'http' => array(
        'header'  => "Content-type: application/x-www-form-urlencoded\r\n",
        'method'  => 'POST',
        'content' => http_build_query($data)
    )
);
$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);

// 获取返回结果的 token, 再传入 playsafe 中播放加密视频
$token = json_decode($result)->data->token;
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

创建 Playsafe Token

接口URL

https://hls.videocc.net/service/v1/token

接口说明

  1. 用于创建 Playsafe Token,这个 token 即是加密视频的播放凭证
  2. 如果一个token尚未过期,此时使用相同的 videoId、viewerId、viewerIp、iswxa 参数值请求该接口,则会复用原来的token,并延长原token的有效期。

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名 必选 类型 说明
userId string 用户ID
videoId string 视频ID,例如 e6b23c6f519c5906e54a13b8200d7bb0_e
ts long 当前13位毫秒级时间戳,10分钟内有效
viewerId string 观看者ID,要求不同的观看者使用不同的ID
viewerIp string 观看者IP,如果为空,会自动获取调用该接口时的IP
viewerName string 观看者名称
expires long token 有效时长,单位为秒。为空时默认为10分钟。
disposable boolean true 表示 token 仅一次有效(验证一次后,token 就失效了)。
false 则表示在有效期内可以多次验证。默认为 false。
iswxa int 是否微信小程序播放,1为是,0为否。默认为0。
extraParams string 自定义的其它参数
sign string 签名,为32位大写的MD5值,详细的签名规则见下文

响应成功JSON示例:

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "token": "973d7731803940a1b14fdc93941f493c",
        "userId": "e6b23c6f51",
        "videoId": "e6b23c6f51c4b1cb9f0302a92ed42440_e",
        "viewerIp": "127.0.0.1",
        "viewerId": "abcd1234",
        "viewerName": null,
        "extraParams": null,
        "ttl": 600000,
        "createdTime": 1552446282044,
        "expiredTime": 1552446882044,
        "iswxa": 0,
        "disposable": false
    }
}

响应失败JSON示例:

userId 错误

{
    "code": 400,
    "status": "error",
    "message": "user_not_found",
    "data": "user secretKey not found."
}

ts 过期

{
    "code": 403,
    "status": "error",
    "message": "ts_expired",
    "data": "ts parameter is expired."
}

签名错误

{
    "code": 403,
    "status": "error",
    "message": "sign_invalid",
    "data": "sign parameter invalid."
}

响应字段说明

参数名 说明
code 响应代码,200为成功,403为ts过期或签名错误,400为参数错误(例如缺少 userId 或 videoId)
status 成功为success,失败为error
message 成功时为空错误时为错误提示消息
data 成功时为token相关数据,失败时为具体的错误提示
userId 用户ID
videoId 视频ID,例如 e6b23c6f519c5906e54a13b8200d7bb0_e
viewerIp 观看者IP,如果为空,或自动获取调用该接口时的IP
viewerId 观看者ID,要求不同的观看者使用不同的ID
viewerName 观看者名称
extraParams 自定义的其它参数
ttl token 有效时长,单位为毫秒
createdTime token 创建时间
expiredTime token 过期时间
iswxa 是否微信小程序播放,1为是,0为否。
disposable true 表示 token 仅一次有效(验证一次后,token 就失效了)。false 则表示在有效期内可以多次验证。

签名规则

  1. 将除了 sign 之外的全部 非空 请求参数(也就是说,参数值为空的参数,将排除掉,不参与签名的计算),按字典序升序排列,按“参数名1参数值1参数名2参数值2……”的格式拼接起来,例如:ts1552447784505userIde6b23c6f51videoIde6b23c6f51c4b1cb9f0302a92ed42440_eviewerIdabcd1234viewerIp127.0.0.1
  2. 在上述字符串的头、尾分别加上 secretKey。以上述字符串、secretKey为abc为例,得到:abcts1552447784505userIde6b23c6f51videoIde6b23c6f51c4b1cb9f0302a92ed42440_eviewerIdabcd1234viewerIp127.0.0.1abc
  3. 计算上述字符串的MD5值,并转为大写,得到:166D45560D37DDBF0F05081D975231B5

php请求示例

// php
function get_client_ip() {
  if (!empty($_SERVER['HTTP_CLIENT_IP'])) {
    $ipaddress = $_SERVER['HTTP_CLIENT_IP'];
  } elseif (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
      $ipaddress = $_SERVER['HTTP_X_FORWARDED_FOR'];
  } else {
      $ipaddress = $_SERVER['REMOTE_ADDR'];
  }
    return $ipaddress;
}

$userId = 'your userId';       // polyv 提供的服务器间的通讯验证
$secretkey = 'your secretkey';     // polyv 提供的接口调用签名访问的key
$videoId = '65956867df8c717eb79136e05394122c_6';  // 视频对应vid
$ts = time() * 1000;      // 时间戳
$viewerIp = get_client_ip();  // 用户 ip
$viewerId = get_viewer_id();      // 自定义用户 id
$viewerName = get_viewer_name();  // 用户昵称, 若值为中文需要urlencode('张三'),可为空
$extraParams = get_extra_params();  // 自定义参数,可为空

/* 将参数 $userId、$secretkey、$videoId、$ts、$viewerIp、$viewerIp、$viewerId、$viewerName、$extraParams
    按照ASCKII升序 key + value + key + value ... +value 拼接
*/
$concated =  'extraParams'.$extraParams.'ts'.$ts.'userId'.$userId.'videoId'.$videoId.'viewerId'.$viewerId.'viewerIp'.$viewerIp.'viewerName'.$viewerName;

// 再首尾加上 secretkey
$plain = $secretkey.$concated.$secretkey;

// 取大写MD5
$sign = strtoupper(md5($plain));



// 然后将下列参数用post请求  https://hls.videocc.net/service/v1/token 获取 token
$url = 'https://hls.videocc.net/service/v1/token';
$data = array('userId' => $userId, 'videoId' => $videoId, 'ts' => $ts, 'viewerIp' => $viewerIp, 'viewerName' => $viewerName, 'extraParams' => $extraParams, 'viewerId' => $viewerId, 'sign' => $sign);

$options = array(
    'http' => array(
        'header'  => "Content-type: application/x-www-form-urlencoded\r\n",
        'method'  => 'POST',
        'content' => http_build_query($data)
    )
);
$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);

// 获取返回结果的 token, 再传入 playsafe 中播放加密视频
$token = json_decode($result)->data->token;
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

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

接口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...

获取单个播放列表

点击这里查看旧版

接口URL

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

接口说明

获取单个播放列表

支持格式

XML/JSON

请求方式

GET

请求数限制

TRUE

请求参数

参数名 必选 类型及范围 说明
userid true string POLYV用户ID,http://api.polyv.net/v2/data/{userid}/viewlog中的{userid}需要替换为POLYV用户ID的值
id true string 播放列表ID
format false string 默认返回json格式,如果format=xml返回xml格式
jsonp false string 例如,正常情况{error:0,data:""},加jsonp=a后返回a({error:0,data:""})
ptime true string 当前时间的毫秒级时间戳(13位),3分钟内有效
sign true string 签名,为40位大写的SHA1值

注意事项

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

PHP示例代码

<?php
$userid="9f1e0689e1";
$id="1474448170995";
$format="";
$jsonp="";
$ptime=time()*1000;
$secretkey="AkDipaULWw";
$str="";
$url="http://api.polyv.net/v2/play/{$userid}/play-list/{$id}?";
if (empty($format)) {
    $str.="id=".$id;
}else{
    $str.="format=".$format."&id=".$id;
    $url.="format=$format&";
}
if (empty($jsonp)) {
    $str.="&ptime=".$ptime.$secretkey;
}else{
    $str.="&jsonp=".$jsonp."&ptime=".$ptime.$secretkey;
    $url.="jsonp=$jsonp&";
}
$hash=strtoupper(sha1($str));
$url.="ptime=$ptime&sign=$hash";
$content=file_get_contents($url);//只能get
echo $content;
?>

返回结果XML示例

<xml>
    <code>200</code>
    <status>success</status>
    <message>success</message>
    <data>
        <describ></describ>
        <tag></tag>
        <title>播放列表1</title>
        <lmodify>2017-04-18 10:01:33</lmodify>
        <video_count>4</video_count>
        <videoid>1474448170995</videoid>
        <ptime>2016-09-21 16:56:10</ptime>
        <videolist>
            <vid>9f1e0689e1a156fc6b373eab9195b0c6_9</vid>
            <title>刘诗昆钢琴教程4</title>
            <duration>00:35:52</duration>
            <publish_url />
            <first_image>http://img.videocc.net/uimage/9/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_0.jpg</first_image>
            <default_videolink></default_videolink>
        </videolist>
        <videolist>
            <vid>9f1e0689e1c98f0cf1554c0d677f0846_9</vid>
            <title>刘诗昆钢琴教程3</title>
            <duration>00:32:50</duration>
            <publish_url />
            <first_image>http://img.videocc.net/uimage/9/9f1e0689e1/6/9f1e0689e1c98f0cf1554c0d677f0846_0.jpg</first_image>
            <default_videolink></default_videolink>
        </videolist>
        <videolist>
            <vid>9f1e0689e10aa6973b4bd7031f6b1fac_9</vid>
            <title>刘诗昆钢琴教程2</title>
            <duration>00:25:15</duration>
            <publish_url />
            <first_image>http://img.videocc.net/uimage/9/9f1e0689e1/c/9f1e0689e10aa6973b4bd7031f6b1fac_0.jpg</first_image>
            <default_videolink></default_videolink>
        </videolist>
        <videolist>
            <vid>9f1e0689e124de49e580c7ec434508f7_9</vid>
            <title>刘诗昆钢琴教程1</title>
            <duration>00:35:51</duration>
            <publish_url />
            <first_image>http://img.videocc.net/uimage/9/9f1e0689e1/7/9f1e0689e124de49e580c7ec434508f7_0.jpg</first_image>
            <default_videolink></default_videolink>
        </videolist>
    </data>
</xml>

返回结果JSON示例

{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": [{
        "describ": "",
        "tag": "",
        "title": "播放列表1",
        "lmodify": "2017-04-18 10:01:33",
        "video_count": "4",
        "videoid": "1474448170995",
        "ptime": "2016-09-21 16:56:10",
        "videolist": [{
            "vid": "9f1e0689e1a156fc6b373eab9195b0c6_9",
            "title": "刘诗昆钢琴教程4",
            "duration": "00:35:52",
            "publish_url": null,
            "first_image": "http://img.videocc.net/uimage/9/9f1e0689e1/6/9f1e0689e1a156fc6b373eab9195b0c6_0.jpg",
            "default_videolink": ""
        }, {
            "vid": "9f1e0689e1c98f0cf1554c0d677f0846_9",
            "title": "刘诗昆钢琴教程3",
            "duration": "00:32:50",
            "publish_url": null,
            "first_image": "http://img.videocc.net/uimage/9/9f1e0689e1/6/9f1e0689e1c98f0cf1554c0d677f0846_0.jpg",
            "default_videolink": ""
        }, {
            "vid": "9f1e0689e10aa6973b4bd7031f6b1fac_9",
            "title": "刘诗昆钢琴教程2",
            "duration": "00:25:15",
            "publish_url": null,
            "first_image": "http://img.videocc.net/uimage/9/9f1e0689e1/c/9f1e0689e10aa6973b4bd7031f6b1fac_0.jpg",
            "default_videolink": ""
        }, {
            "vid": "9f1e0689e124de49e580c7ec434508f7_9",
            "title": "刘诗昆钢琴教程1",
            "duration": "00:35:51",
            "publish_url": null,
            "first_image": "http://img.videocc.net/uimage/9/9f1e0689e1/7/9f1e0689e124de49e580c7ec434508f7_0.jpg",
            "default_videolink": ""
        }]
    }]
}

字段说明

字段 说明
code 返回码
status 返回状态
message 返回信息
describ 详细介绍
tag 标签
title 播放列表标题
lmodify 最后修改时间
video_count 视频数量
videoid 视频列表ID
ptime 创建时间
videolist 视频集合
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

新建播放列表

createPlayList

    作用:创建播放列表

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选是否必须类型说明
writetokentruestring用户的写密钥
tagfalsestring视频标签
titletruestring标题
descfalsestring 描述

返回结果

<xml>
<error>0</error>
<total/>
</xml>

JSON示例

{
id: 1456889162568,
error: "0"
}

字段说明

字段说明
id播放列表的id
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

修改播放列表

modifyPlayList

    作用:修改播放列表

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选是否必须类型说明
idtruelong播放列表id
writetokentruestring用户的写密钥
tagfalsestring视频标签
titletruestring标题
descfalsestring 描述
以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
Loading...

移动视频到播放列表

addToPlayList

    作用:创建播放列表

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型说明
idtruelong播放列表的id,在“视频管理”——“播放列表”中可以获取,如下图所示
writetokentruestring用户的写密钥
vidtruelong视频id
1

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

将视频从播放列表移除

removeFromPlayList

    作用:将视频从播放列表移除

URL

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

支持格式

    XML/JSON

HTTP请求方式

    POST,GET

请求数限制

    TRUE

请求参数

参数名必选类型说明
idtruelong播放列表的id,在“视频管理”——“播放列表”中可以获取,如下图所示
writetokentruestring用户的写密钥
vidtruelong视频id
1

以上内容是否对您有帮助?根本没有帮助文档较差文档一般文档不错文档很好
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...