直播平台API | 保利威帮助中心

修改直播频道分类顺序

2020年1月10日由文丰勇发表

接口URL

http://api.polyv.net/live/v3/user/category/update-rank

接口说明

1、修改账号下直播频道分类的顺序
2、接口支持https协议
3、默认分类不允许移动顺序

请求方式

POST

请求参数

参数名	必选	类型	说明
categoryId	是	int	分类id
afterCategoryId	是	int	移动到该id对应的分类之后
appId	是	string	从API设置中获取，在直播系统登记的appId
sign	是	string	签名，为32位大写的MD5值
timestamp	是	long	当前13位毫秒级时间戳，3分钟内有效

响应成功JSON示例：

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": ""
}

响应异常JSON示例：

{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}

字段说明

参数名	说明
code	请求状态响应码
status	请求状态
message	错误信息
data	空

php请求示例

<?php
//引用config.php
include 'config.php';

$params = array(
  'appId' => $appId,
  'timestamp' => $timestamp,
  'afterCategoryId' => 90,
  'categoryId' => 36
);

//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法
$params['sign'] = $sign;

$url = "http://api.polyv.net/live/v3/user/category/update-rank?".http_build_query($params);

$curl = curl_init();
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 500);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, 1);
$res = curl_exec($curl);
curl_close($curl);

echo $res;
?>

签名规则(config.php文件代码查看)

http://dev.polyv.net/2018/liveproduct/l-api/rule/sign/

以上内容是否对您有帮助？ 根本没有帮助

删除直播频道分类

2020年1月10日由文丰勇发表

接口URL

http://api.polyv.net/live/v3/user/category/delete

接口说明

1、删除账号下直播频道分类
2、接口支持https协议
3、默认分类不允许删除

请求方式

POST

请求参数

参数名	必选	类型	说明
categoryId	是	inte	分类id
appId	是	string	从API设置中获取，在直播系统登记的appId
sign	是	string	签名，为32位大写的MD5值
timestamp	是	long	当前13位毫秒级时间戳，3分钟内有效

响应成功JSON示例：

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": ""
}

响应异常JSON示例：

{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}

字段说明

参数名	说明
code	请求状态响应码
status	请求状态
message	错误信息
data	空

php请求示例

<?php
//引用config.php
include 'config.php';

$params = array(
  'appId' => $appId,
  'timestamp' => $timestamp,
  'categoryName' => '一级目录',
  'categoryId' => 36
);

//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法
$params['sign'] = $sign;

$url = "http://api.polyv.net/live/v3/user/category/delete?".http_build_query($params);

$curl = curl_init();
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 500);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, 1);
$res = curl_exec($curl);
curl_close($curl);

echo $res;
?>

签名规则(config.php文件代码查看)

http://dev.polyv.net/2018/liveproduct/l-api/rule/sign/

以上内容是否对您有帮助？ 根本没有帮助

修改直播频道分类名称

2020年1月10日由文丰勇发表

接口URL

http://api.polyv.net/live/v3/user/category/update-name

接口说明

1、修改账号下直播频道分类的名称
2、接口支持https协议
3、默认分类不允许修改名称

请求方式

POST

请求参数

参数名	必选	类型	说明
categoryName	是	string	分类名称
categoryId	是	int	分类id
appId	是	string	从API设置中获取，在直播系统登记的appId
sign	是	string	签名，为32位大写的MD5值
timestamp	是	long	当前13位毫秒级时间戳，3分钟内有效

响应成功JSON示例：

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": ""
}

响应异常JSON示例：

{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}

字段说明

参数名	说明
code	请求状态响应码
status	请求状态
message	错误信息
data	空

php请求示例

<?php
//引用config.php
include 'config.php';

$params = array(
  'appId' => $appId,
  'timestamp' => $timestamp,
  'categoryName' => '一级目录',
  'categoryId' => 36
);

//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法
$params['sign'] = $sign;

$url = "http://api.polyv.net/live/v3/user/category/update-name?".http_build_query($params);

$curl = curl_init();
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 500);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, 1);
$res = curl_exec($curl);
curl_close($curl);

echo $res;
?>

签名规则(config.php文件代码查看)

http://dev.polyv.net/2018/liveproduct/l-api/rule/sign/

以上内容是否对您有帮助？ 根本没有帮助

查询频道图文内容列表

2019年11月19日由严俤仔发表

接口URL

https://api.polyv.net/live/v3/channel/watch/tuwen/list

接口说明

1、接口用于获取频道图文内容列表
2、接口支持https

支持格式

JSON

请求方式

GET

请求数限制

TRUE

请求参数

参数名	必选	类型	说明
appId	是	string	从API设置中获取，在直播系统登记的appId
timestamp	是	long	当前13位毫秒级时间戳，3分钟内有效
sign	是	string	签名，为32位大写的MD5值
channelId	是	int	频道号
id	否	int	图文内容的序列号：为空表示获取第一页数据，且同时会返回置顶数据。非空表示获取 id 比该值小的记录（也就是更早发布的内容），此时不返回置顶列表。
imageMode	否	string	是否为图片模式，Y表示为图片模式，N表示文字加图片的模式，默认为N

响应成功JSON示例：

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "total": 5,
        "contents": [
            {
                "id": 17378,
                "channelId": 409708,
                "text": "<p>对对对</p>",
                "images": [
                    "http://liveimages.videocc.net/uploadimage/20191119/chat_img_409708_15741331430886.png",
                    "http://liveimages.videocc.net/uploadimage/20191119/chat_img_409708_15741331490988.jpeg"
                ],
                "top": "N",
                "createdTime": 1574133151000
            },
            {
                "id": 17376,
                "channelId": 409708,
                "text": "<p>地方地方地方</p>",
                "images": [
                    "http://liveimages.videocc.net/uploadimage/20191119/chat_img_409708_15741331256627.jpeg"
                ],
                "top": "N",
                "createdTime": 1574133129000
            },
            {
                "id": 17374,
                "channelId": 409708,
                "text": "<p>顶顶顶顶</p>",
                "images": [],
                "top": "N",
                "createdTime": 1574133116000
            },
            {
                "id": 17372,
                "channelId": 409708,
                "text": "<p>dddddd哈哈哈</p>",
                "images": [
                    "http://liveimages.videocc.net/uploadimage/20191119/chat_img_409708_15741323650758.jpeg"
                ],
                "top": "N",
                "createdTime": 1574132371000
            },
            {
                "id": 17370,
                "channelId": 409708,
                "text": "<p>hello</p>",
                "images": [
                    "http://liveimages.videocc.net/uploadimage/20191119/chat_img_409708_15741323407247.png"
                ],
                "top": "Y",
                "createdTime": 1574132348000
            }
        ],
        "topContents": [
            {
                "id": 17370,
                "channelId": 409708,
                "text": "<p>hello</p>",
                "images": [
                    "http://liveimages.videocc.net/uploadimage/20191119/chat_img_409708_15741323407247.png"
                ],
                "top": "Y",
                "createdTime": 1574132348000
            }
        ],
        "setting": {
            "id": 22162,
            "nickname": "主持人",
            "actor": "主持人",
            "avatar": "//livestatic.videocc.net/assets/wimages/pc_images/logo.png"
        }
    }
}

响应失败JSON示例：

未输入appId

{
    "code": 400,
    "status": "error",
    "message": "appId is required.",
    "data": ""
}

appId不正确

{
    "code": 400,
    "status": "error",
    "message": "application not found.",
    "data": ""
}

时间戳错误

{
    "code": 400,
    "status": "error",
    "message": "invalid timestamp.",
    "data": ""
}

签名错误

{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}

频道号格式错误

{
  "code": 400, 
  "status": "error", 
  "message": "param is not digit: dsadasd", 
  "data": ""
}

字段说明

参数名	说明
code	响应代码，成功为200，失败为400，签名错误为401，异常错误500
status	成功为success，失败为error
message	错误时为错误提示消息
data	成功响应时为回放详情分页数据
total	总的返回结果条数
contents	返回的图文列表内容，是个数组
id	图文内容序列号,可用于查询条件参数id
channelId	频道ID
text	文本内容
images	图片地址，是个数组
top	是否置顶，Y表示是，N表示否
createdTime	内容发送的时间，13位的时间戳
topContents	置顶的图文信息，是个数组
id	图文内容序列号,可用于查询条件参数id
channelId	频道ID
text	文本内容
images	图片地址，是个数组
top	是否置顶，Y表示是，N表示否
createdTime	内容发送的时间，13位的时间戳
setting	图文直播相关设置信息
id	设置的序列号
nickname	操作人的昵称
actor	操作人的头衔
avatar	操作人的头像

php请求示例

<?php
//引用config.php
include 'config.php';

$params = array(
  'appId' => $appId,
  'timestamp' => $timestamp,
  'channelId' => 206204,
  'imageMode' => 'N',
  'id' => 5
);

//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法
$params['sign'] = $sign;

$url = "https://api.polyv.net/live/v3/channel/watch/tuwen/list?".http_build_query($params);

$curl = curl_init();
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 500);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, 0);
$res = curl_exec($curl);
curl_close($curl);

echo $res;
?>

签名规则(config.php文件代码查看)

http://dev.polyv.net/2018/liveproduct/l-api/rule/sign/

以上内容是否对您有帮助？

设置密码

2019年11月12日由莫顺伟发表

接口URL

https://api.polyv.net/live/v3/user/update-password

接口说明

设置密码

支持格式

JSON

请求方式

POST

请求参数

参数名	必选	类型及范围	说明
sign	true	string	签名
appId	true	string	开发者账号下的appId
timestamp	true	string	13位当前时间的时间戳
newPassword	true	string	新密码

返回错误结果JSON示例

签名错误：
{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}
密码长度不正确：
{
    "code": 1113,
    "status": "error",
    "message": "param length is incorrect: newPassword",
    "data": ""
}

返回正确结果JSON示例

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": ""
}

字段说明

字段	类型及范围	说明
code	int32	返回码
status	string	返回状态
message	string	返回信息
data	string	操作结果

PHP请求示例

<?php

//引用config.php
include 'config.php';

//接口需要的参数（非sign）赋值
$appId = "XXXXXXXX";
$newPassword = "127075";
$timestamp = "123123123123";
$params = array(
        'appId'=>$appId,
        'newPassword'=>$newPassword,
        'timestamp'=>$timestamp
    );

//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法
$params['sign'] = $sign;

$url = "https://api.polyv.net/live/v3/user/update-password?".http_build_query($params);

$ch = curl_init() or die ( curl_error() );
curl_setopt( $ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT, 360);
$response = curl_exec ( $ch );
curl_close ( $ch );
echo $response;
?>

签名规则(config.php文件代码查看)

http://dev.polyv.net/2018/liveproduct/l-api/rule/sign/

以上内容是否对您有帮助？ 根本没有帮助

查询指定签到ID的签到记录

2019年10月29日由莫顺伟发表

接口URL

https://api.polyv.net/live/v3/channel/chat/get-checkins

接口说明

通过签到ID获取该次签到记录

支持格式

JSON

请求方式

GET

请求参数

参数名	必选	类型及范围	说明
sign	true	string	签名
appId	true	string	开发者账号下的appId
timestamp	true	string	13位当前时间的时间搓
channelId	true	int32	频道号
checkinId	true	string	签到ID

返回错误结果JSON示例

签名错误：
{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}
非法频道号：
{
    "code": 403,
    "status": "error",
    "message": "illegal channel id: 372228",
    "data": ""
}

返回正确结果JSON示例

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": [
        {
            "checkinid": "e45f4d20-f5fe-11e9-bb7b-0fb636",
            "nickname": "广州观众/86958",
            "checked": "Y",
            "indate": "2019-10-24",
            "id": 523520,
            "sessionId": "fh6o6k46kx",
            "time": 1571881076840,
            "userid": "1571881038428",
            "roomid": "372228"
        }
    ]
}

返回结果data表示成功修改的数量.

字段说明

字段	说明
code	返回码
status	返回状态
message	返回信息
data	操作结果

数据对象字段说明

字段	类型及范围	说明
checkinid	string	签到时间
nickname	string	签到学员名称
checked	string	签到Y,未签到N
indate	string	签到日期
id	int32	签到记录主键
sessionId	string	场次号
time	long	签到时间
userid	string	签到学员ID
roomid	string	房间号

PHP请求示例

<?php

//引用config.php
include 'config.php';

//接口需要的参数（非sign）赋值
$appId = "XXXXXXXX";
$channelId = "127075";
$checkinId = "xxxxxx";
$timestamp = "123123123123";
$params = array(
        'appId'=>$appId,
        'checkinId'=>$checkinId,
        'channelId'=>$channelId,
        'timestamp'=>$timestamp
    );
//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法

$url="https://api.polyv.net/live/v3/channel/chat/get-checkin?appId=$appId&channelId=$channelId&checkinId=$checkinId&sign=$sign&timestamp=$timestamp";

$ch = curl_init() or die ( curl_error() );
curl_setopt( $ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT, 360);
$response = curl_exec ( $ch );
curl_close ( $ch );
echo $response;

?>

签名规则(config.php文件代码查看)

http://dev.polyv.net/2018/liveproduct/l-api/rule/sign/

以上内容是否对您有帮助？ 根本没有帮助

查询指定直播场次sessionId的签到场次记录

2019年10月29日由莫顺伟发表

接口URL

https://api.polyv.net/live/v3/channel/chat/checkin-by-sessionId

接口说明

通过直播场次sessionId获取直播发起签到记录

支持格式

JSON

请求方式

GET

请求参数

参数名	必选	类型及范围	说明
sign	true	string	签名
appId	true	string	开发者账号下的appId
timestamp	true	string	13位当前时间的时间戳
channelId	true	int32	频道号
sessionId	true	string	场次号

返回错误结果JSON示例

签名错误：
{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}
时间戳错误：
{
    "code": 400,
    "status": "error",
    "message": "invalid timestamp.",
    "data": ""
}

返回正确结果JSON示例

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": [
        {
            "createtime": "2019-10-24 09:37:51",
            "checkinid": "e45f4d20-f5fe-11e9-bb7b-0fb636",
            "sessionId": "fh6o6k46kx",
            "roomid": "372228"
        },
        {
            "createtime": "2019-10-24 09:46:41",
            "checkinid": "204cae80-f600-11e9-bb7b-0fb636",
            "sessionId": "fh6o6k46kx",
            "roomid": "372228"
        }
    ]
}

返回结果data表示成功修改的数量.

字段说明

字段	类型及范围	说明
code	int32	返回码
status	string	返回状态
message	string	返回信息
data	string	操作结果

数据对象字段说明

字段	类型及范围	说明
createtime	string	签到时间
checkinid	string	签到ID
sessionId	string	场次号
roomid	string	房间号

PHP请求示例

<?php

//引用config.php
include 'config.php';

//接口需要的参数（非sign）赋值
$userId = "XXXXXXXX";
$channelId = "127075";
$sessionId = "xxxxxx";
$timestamp = "123123123123";
$params = array(
        'appId'=>$appId,
        'sessionId'=>$sessionId,
        'channelId'=>$channelId,
        'timestamp'=>$timestamp
    );
//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法

$url="https://api.polyv.net/live/v3/channel/chat/checkin-by-sessionId?appId=$appId&channelId=$channelId&sessionId=$sessionId&sign=$sign&timestamp=$timestamp";

$ch = curl_init() or die ( curl_error() );
curl_setopt( $ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT, 360);
$response = curl_exec ( $ch );
curl_close ( $ch );
echo $response;

?>

签名规则(config.php文件代码查看)

http://dev.polyv.net/2018/liveproduct/l-api/rule/sign/

以上内容是否对您有帮助？ 根本没有帮助

查询授权和连麦的token

2019年10月21日由严俤仔发表

接口URL

http://api.polyv.net/live/v3/channel/common/get-chat-token

接口说明

1、接口用于获取授权和连麦的token
2、接口支持https

支持格式

JSON

请求方式

GET POST

请求数限制

TRUE

请求参数

参数名	必选	类型	说明
appId	是	string	从API设置中获取，在直播系统登记的appId
timestamp	是	long	13位当前时间戳
sign	是	string	签名值
channelId	是	int	频道Id
userId	是	String	观看者用户ID
role	是	String	角色，值有：teacher admin guest assistant viewer等
origin	否	String	观看来源

响应成功JSON示例：

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
"mediaChannelKey": "e2355436235ba12d4c56493b575afed38f9f061d044f54d93c30f01463ffea852a7119c6195c6abf51b4682bc596bf5962eddc6cbf82784a1e5309ac52220ef7e66e4e7eb69a4e80081056972d5a9cb3bb723a0cb090702eef99369d479482b3bad99e5ec50eae5607b82c58da59aac3eada29fe6d753ef358d064ee308e406b3091f5256a77251001f99b6815651f18982da983b58c79d9caedd5ccec3f20ecd3dde7ba370f3c0ca0aa8c3ef088148523019f06e224d030b871da390c4a1a1c646e26684895d544dbba47751c535d07ea765fcf0cdfe8fe3de1538e4fe69eecadfd4a8b431aa4b00bc5dbccdb996ea3b7f962da2ecc21b6b14ba70c33601c53c3aa8d8e4857c111fa076e47e3a6eafc9601b87c079361f2d0f3cb4b31df2ff088ccb9428abe324ecb9e07e2fb8f48e40ab2ef3e119cfd93b15259bfa390938485a8fcd2e200dadeefe15a0516b7f61736cbe5bf48564d100e28ff64f979ebf42eadd3a0f3d58565d1ab619884d78c29",
"token": "71b961e6b2a68cde9559966b2f46d4e0"
}
}

响应字段说明

参数名	说明
code	状态码,成功为200，签名失败为403，参数错误为400，服务端错误为500
status	成功为success,错误时为error
message	成功为""，错误时为错误描述信息
data.token	链接接口需要的token值
data.mediaChannelKey	连麦需要的key

响应失败JSON示例：

参数错误

{
    "code": 400,
    "status": "error",
    "message": "param validate error",
    "data": 400
}

未输入appId

{
    "code": 400,
    "status": "error",
    "message": "appId is required.",
    "data": ""
}

appId不正确

{
    "code": 400,
    "status": "error",
    "message": "application not found.",
    "data": ""
}

时间戳错误

{
    "code": 400,
    "status": "error",
    "message": "invalid timestamp.",
    "data": ""
}

签名错误

{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}

php请求示例

<?php
//引用config.php
include 'config.php';

$params = array(
  'appId' => $appId,
  'timestamp' => $timestamp,
  'userId' => $userId,
  'role' => $role,
  'origin' => $origin,
  'channelId' =>  195770
);

//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法
$params['sign'] = $sign;

$url = "http://api.polyv.net/live/v3/channel/common/get-chat-token?".http_build_query($params);

$curl = curl_init();
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 500);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, 1);
$res = curl_exec($curl);
curl_close($curl);

echo $res;
?>

签名规则(config.php文件代码查看)

http://dev.polyv.net/2018/liveproduct/l-api/rule/sign/

以上内容是否对您有帮助？ 根本没有帮助

查询频道广告列表

2019年9月3日由莫顺伟发表

接口URL

http://api.polyv.net/live/v3/channel/advert/list

接口说明

1、提供查询频道轮播广告列表信息，频道广告为空时，获取全局广告
2、支持https

支持格式

JSON

请求方式

GET

请求参数

参数名	必选	类型	说明
appId	是	string	账号应用下的appId
timestamp	是	string	当前时间的秒级时间戳（13位）
sign	是	string	签名，为32位大写的MD5值
channelId	是	int	频道号

操作成功响应示例

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": [
        {
            "text": "",
            "img": "//liveimages.videocc.net/uploaded/images/2019/09/ffmgstpk58.png",
            "href": ""
        },
        {
            "text": "123445",
            "img": "",
            "href": ""
        }
    ]
}

操作失败响应示例

签名错误

{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}

缺少参数 channelId

{
    "code": 400,
    "status": "error"
    "message": "param should not be empty: channelId",
    "data": ""
}

响应字段说明

名称	类型	说明
code	string	响应代码，成功为200，失败为400，签名错误为403，异常错误500
status	string	成功为success，失败为error
message	string	错误时为错误提示消息
data	object[]	成功响应数据
text	string	文本广告内容
img	string	图片广告链接
href	string	跳转链接

php请求示例

<?php
//引用config.php
include 'config.php';

$params = array(
    'appId' => $appId,
    'timestamp' => $timestamp,
    'channelId' => 206204
);

//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法
$params['sign'] = $sign;

//接口请求url
$url = "https://api.polyv.net/live/v3/channel/advert/list?appId=".$appId."&sign=".$sign."&timestamp=".$timestamp."&channelId=".$channelId;
//输出接口请求结果
echo file_get_contents($url);

?>

签名规则(config.php文件代码查看)

http://dev.polyv.net/2018/liveproduct/l-api/rule/sign/

以上内容是否对您有帮助？ 根本没有帮助

查询指定文件ID的录制文件信息

2019年8月29日由黄裕丰发表

接口URL

https://api.polyv.net/live/v3/channel/record/get

接口说明

1、接口用于通过文件ID查询录制文件信息
2、接口支持https

支持格式

JSON

请求方式

GET

请求参数

参数名	必选	类型	说明
appId	是	string	从API设置中获取，在直播系统登记的appId
timestamp	是	long	当前13位毫秒级时间戳，3分钟内有效
sign	是	string	签名，为32位大写的MD5值
channelId	是	string	频道号
fileId	是	string	文件ID

响应成功JSON示例：

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "bitrate": 0, 
        "channelId": 339382, 
        "channelSessionId": "fdl03sz2mx", 
       "createdTime": 1561719918000, 
       "duration": 78, 
       "endTime": "20190628190217", 
       "fileId": "d2c7428031a512a2f8c53da358f9695e", 
       "filename": "测试创建", 
       "filesize": 5110372, 
       "height": 720, 
       "liveType": "ppt", 
       "m3u8": "http://oss-live-1.videocc.net/record/record/recordf/edvf2fpec920190621142457386/2019-06-28-19-00-58_2019-06-28-19-02-16.m3u8", 
       "mp4": "http://oss-live-1.videocc.net/record/record/recordf/edvf2fpec920190621142457386/2019-06-28-19-00-58_2019-06-28-19-02-16.mp4",
       "startTime": "20190628190057",
       "userId": "edvf2fpec9", 
       "width": 1280
    }
}

响应失败JSON示例：

未输入appId

{
    "code": 400,
    "status": "error",
    "message": "appId is required.",
    "data": ""
}

appId不正确

{
    "code": 400,
    "status": "error",
    "message": "application not found.",
    "data": ""
}

时间戳错误

{
    "code": 400,
    "status": "error",
    "message": "invalid timestamp.",
    "data": ""
}

签名错误

{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}

字段说明

参数名	说明
code	响应的状态码，例如：200
status	响应状态
message	异常错误信息
data	响应结果集
bitrate	码率
channelId	频道号
channelSessionId	频道场次
createdTime	创建时间
duration	时长
endTime	结束时间
fileId	文件ID
filename	文件名
filesize	文件大小
height	高
liveType	直播类型
m3u8	m3u8文件地址
mp4	MP4地址
startTime	开始时间
userId	用户ID
width	宽

php请求示例

<?php
//引用config.php
include 'config.php';
$params = array(
    'appId' => $appId,
    'timestamp' => $timestamp,
    'channelId' => 108888,
    'fileId' => '11111dadadadadade2323'
);

//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法
$params['sign'] = $sign;

$url = "https://api.polyv.net/live/v3/channel/record/get?".http_build_query($params);

$curl = curl_init();
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 500);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_URL, $url);
$res = curl_exec($curl);
curl_close($curl);

echo $res;
?>

签名规则(config.php文件代码查看)

http://dev.polyv.net/2018/liveproduct/l-api/rule/sign/

以上内容是否对您有帮助？ 根本没有帮助

软件下载 云直播 云点播

使用手册 云直播 云点播

开发者中心 云直播 云点播

视频教程 视频学院 云直播 云点播

功能大全 云直播 云点播

接口URL

接口说明

请求方式

请求参数

字段说明

php请求示例

签名规则(config.php文件代码查看)

接口URL

接口说明

请求方式

请求参数

字段说明

php请求示例

签名规则(config.php文件代码查看)

接口URL

接口说明

请求方式

请求参数

字段说明

php请求示例

签名规则(config.php文件代码查看)

接口URL

接口说明

支持格式

请求方式

请求数限制

请求参数

响应成功JSON示例：

响应失败JSON示例：

字段说明

php请求示例

签名规则(config.php文件代码查看)

接口URL

接口说明

支持格式

请求方式

请求参数

返回错误结果JSON示例

返回正确结果JSON示例

字段说明

PHP请求示例

签名规则(config.php文件代码查看)

接口URL

接口说明

支持格式

请求方式

请求参数

返回错误结果JSON示例

返回正确结果JSON示例

字段说明

数据对象字段说明

PHP请求示例

签名规则(config.php文件代码查看)

接口URL

接口说明

支持格式

请求方式

请求参数

返回错误结果JSON示例

返回正确结果JSON示例

字段说明

数据对象字段说明

PHP请求示例

签名规则(config.php文件代码查看)

接口URL

接口说明

支持格式

请求方式

请求数限制

请求参数

响应成功JSON示例：

响应字段说明

响应失败JSON示例：

php请求示例

签名规则(config.php文件代码查看)

软件下载云直播云点播

使用手册云直播云点播

开发者中心云直播云点播

视频教程视频学院云直播云点播

功能大全云直播云点播