服务端API | 保利威帮助中心

批量删除视频

2021年1月7日由钟东东发表

接口URL

http://api.polyv.net/v2/video/del-videos

接口说明

(接口调用有频率限制，详细请查看)

批量删除视频

返回结果支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名	必选	类型及范围	说明
userId	true	string	用户ID
vids	true	string	视频ID，多个视频以英文逗号(,)隔开，一次最多提交500个
sign	true	string	签名，40位大写的sha1值
ptime	true	long	当前13位毫秒级时间戳，3分钟内有效
deleteType	false	int	删除方式，1：删除到回收站，2：彻底删除，默认为：1

JSON示例

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

返回错误json

签名不正确
{
"code":400,
"status":"error",
"message":"the sign is not right",
"data":""
}

时间戳过期
{
"code":400,
"status":"error",
"message":"ptime is too old.",
"data":""
}

参数为空
{
"code":400,
"status":"error",
"message":"xxx is empty",
"data":""
}

删除视频一次最多只能提交500个
{
"code":400,
"status":"error",
"message":"delete vids size can't greater than 500 once",
"data":""
}

字段说明

字段	说明
code	请求返回状态码
status	请求返回状态
message	请求返回信息
data	返回数据

java请求示例

public void testDeleteVideos() {
        String url = "http://api.polyv.net/v2/video/del-videos";
        String userId = "xxxxxxx";
        String vids = "e6bt3c6f513fbe025b94efdd10d7am47_e,e6bt3c6f513fbe025b94efddm0d7am47_e";
        String secretkey = "xxxxxxx";
        long ptime = System.currentTimeMillis();
        Map<String, String> params = new HashMap<>();
        params.put("deleteType", "1");
        params.put("ptime", String.valueOf(ptime));
        params.put("userId", userId);
        params.put("vids", vids);
        params.put("sign", getSign(params, secretkey));
        String response = HttpClientUtil.getInstance().sendHttpPost(url, params);
        System.out.println(response);
}

点播API签名规则

https://dev.polyv.net/2020/videoproduct/v-api/v-api-signs/vod-sign/

通用工具类

https://dev.polyv.net/2020/liveproduct/l-api/rule/live-api-java-detail/

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

视频禁播与解禁

2020年11月13日由钟东东发表

接口URL

https://api.polyv.net/v2/video/{userid}/forbidden

接口说明

(接口调用有频率限制，详细请查看)

用于禁止、解禁播放视频，禁播后会将视频状态（status）设置成53，一次最多只能操作500个vid
支持https
注意点：
  只能修改“已发布”状态的视频为禁播状态，
  只能修改“已禁播”状态的视频为已发布状态，
  当请求中的vid包含多种状态时，只对符合条件的vid进行状态修改操作，并返回成功；若没有符合条件的vid则返回错误。

返回结果支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数

参数名	必选	类型及范围	说明
ptime	true	long	13位的当前时间毫秒级时间戳
sign	true	string	签名
userId	true	string	userId，路径参数
vids	true	string	视频vid，多个视频以英文逗号分隔，如a2dc4f25179499d6586362672838cc2d_a,a2dc4f25179499d6586362672838cc2d_a 一次最多只能传500个vid
forbidden	true	int	1：禁播，0：解禁

返回结果

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

请求失败返回json示例

签名错误
{
    "code": 400,
    "status": "error",
    "message": "the sign is not right.",
    "data": ""
}
时间戳过期
{
    "code": 400,
    "status": "error",
    "message": "ptime is too old",
    "data": ""
}

一次最多只能操作500个vid
{
    "code": 400,
    "status": "error",
    "message": "vid count can't over 500",
    "data": ""
}

只能修改“已发布”状态的视频为禁播状态
{
    "code": 400,
    "status": "error",
    "message": "只能修改“已发布”状态的视频为禁播状态",
    "data": ""
}

只能修改“已禁播”状态的视频为已发布状态
{
    "code": 400,
    "status": "error",
    "message": "只能修改“已禁播”状态的视频为已发布状态",
    "data": ""
}

字段说明

字段	类型	说明
code	int	请求返回状态码
status	string	请求返回状态
message	string	请求返回信息
data	string	请求返回数据

Java示例代码

public class Test {

    public static void main(String[] args) throws Exception {
        String userId = "xxxxxx";
        String secretkey = "xxxxxxx";
        String url = "https://api.polyv.net/v2/video/%s/forbidden";
        url = String.format(url, userId);
        Map<String, String> params = new HashMap<>();
        params.put("vids", "xxxxxx,xxxxxx");
        long ptime = System.currentTimeMillis();
        params.put("ptime", String.valueOf(ptime));
        params.put("forbidden", "1");
        params.put("sign", getSign(params, secretkey));
        String response = HttpClientUtil.getInstance().sendHttpPost(url, params);
        System.out.println(response);
    }
}

点播API签名规则

https://dev.polyv.net/2020/videoproduct/v-api/v-api-signs/vod-sign/

通用工具类

https://dev.polyv.net/2020/liveproduct/l-api/rule/live-api-java-detail/

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

查询视频信息

2020年7月30日由钟东东发表

接口URL

https://api.polyv.net/v3/video/get-video-info

接口说明

(接口调用有频率限制，详细请查看)

1、接口用于查询视频信息
2、接口支持https

请求方式

GET,POST

请求参数

参数名	必选	类型	说明
appId	是	string	子账号appId
timestamp	是	long	当前13位当前时间戳，3分钟有效
sign	是	string	签名值，32位大写MD5值
vids	是	string	视频ID，多个视频ID用英文逗号分隔
filter	否	string	选择需要返回的视频信息，多个以英文逗号分隔，取值：basicInfo,metaData,transcodeInfo,snapshotInfo, 分别代表基础信息、元数据、转码信息、截图信息，为空则返回基础信息

响应成功JSON示例：

// 请求成功
{
    "requestId": "0320c7a6-223c-437e-b694-1f652f1f44d0",
    "code": 200,
    "status": "success",
    "error": null,
    "data": [
        {
            "vid": "a2dc4f25172872650e7d5c1b8026b13c_a",
            "basicInfo": {
                "title": "合并-a2dc4f25175d64f185bf631591fb08d0",
                "description": "",
                "duration": 246.0,
                "coverURL": "https://img.videocc.net/uimage/a/a2dc4f2517/first_image/76031009-3478-4b0e-a711-52dcccd7557c_b.jpg",
                "creationTime": "2021-04-30 01:03:41",
                "updateTime": "2021-05-01 00:33:55",
                "size": 115608008,
                "status": 61,
                "cateId": 1,
                "cateName": "默认分类",
                "tags": "",
                "uploader": null,
                "playTimes": 6
            },
            "metaData": {
                "size": 115608008,
                "format": "flv",
                "duration": 246.0,
                "bitrate": 3017,
                "fps": 0,
                "height": 1080,
                "width": 1920,
                "codec": "h264"
            },
            "transcodeInfos": [
                {
                    "playUrl": "https://mpv.videocc.net/a2dc4f2517/c/a2dc4f25172872650e7d5c1b8026b13c_1.mp4",
                    "definition": "LD",
                    "bitrate": 602,
                    "duration": 246.0,
                    "encrypt": false,
                    "format": "mp4",
                    "fps": 0,
                    "height": 1080,
                    "width": 1920,
                    "status": "normal"
                }
            ],
            "snapshotInfo": {
                "imageUrl": [
                    "https://img.videocc.net/uimage/a/a2dc4f2517/c/a2dc4f25172872650e7d5c1b8026b13c_0.jpg",
                    "https://img.videocc.net/uimage/a/a2dc4f2517/c/a2dc4f25172872650e7d5c1b8026b13c_1.jpg",
                    "https://img.videocc.net/uimage/a/a2dc4f2517/c/a2dc4f25172872650e7d5c1b8026b13c_2.jpg",
                    "https://img.videocc.net/uimage/a/a2dc4f2517/c/a2dc4f25172872650e7d5c1b8026b13c_3.jpg",
                    "https://img.videocc.net/uimage/a/a2dc4f2517/c/a2dc4f25172872650e7d5c1b8026b13c_4.jpg",
                    "https://img.videocc.net/uimage/a/a2dc4f2517/c/a2dc4f25172872650e7d5c1b8026b13c_5.jpg"
                ]
            }
        }
    ]
}

响应失败JSON示例：

// 时间戳错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 100,
        "desc": "invalid timestamp"
    },
    "data": null
}

// appId不正确
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 101,
        "desc": "application not exist"
    },
    "data": null
}

// 子账号不存在
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 102,
        "desc": "user children not exist"
    },
    "data": null
}

// 子账号过期
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 103,
        "desc": "user children expired"
    },
    "data": null
}

// 签名错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 104,
        "desc": "invalid signature"
    },
    "data": null
}

// 账号权限不足
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 105,
        "desc": "permission limited"
    },
    "data": null
}

// 视频vid错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 2000,
        "desc": "invalid vid"
    },
    "data": null
}

字段说明

字段	说明
requestId	本次请求的ID
code	响应http状态码
status	状态
error.code	错误码
error.desc	错误描述
data	返回数据
data[0].vid	视频id
data[0].basicInfo.title	视频标题
data[0].basicInfo.description	视频描述
data[0].basicInfo.duration	源视频时长，单位：秒
data[0].basicInfo.coverURL	首图地址，大图
data[0].basicInfo.creationTime	创建时间
data[0].basicInfo.updateTime	更新时间
data[0].basicInfo.size	源文件大小，单位：Bytes
data[0].basicInfo.status	视频状态码
data[0].basicInfo.cateId	分类id, 如1为根目录
data[0].basicInfo.cateName	分类名称
data[0].basicInfo.tags	标签
data[0].basicInfo.uploader	上传者
data[0].transcodeInfos.playUrl	播放地址
data[0].transcodeInfos.definition	清晰度，SOURCE:原清晰度,LD:普清,SD:标清,HD:高清
data[0].transcodeInfos.duration	时长，秒
data[0].transcodeInfos.encrypt	加密视频为true，非加密为false
data[0].transcodeInfos.format	转码格式，如mp4、flv、pdx、hls
data[0].transcodeInfos.fps	视频帧率
data[0].transcodeInfos.bitrate	码率kbps
data[0].transcodeInfos.height	分辨率高，单位：px
data[0].transcodeInfos.width	分辨率宽，单位：px
data[0].transcodeInfos.status	视频状态, normal:可以正常播放,unavailable:不能正常播放
data[0].metaData.size	源文件大小，单位：Bytes
data[0].metaData.format	视频容器类型，如mp4、flv等
data[0].metaData.duration	源视频时长，单位：秒
data[0].metaData.bitrate	视频码率，单位：bps
data[0].metaData.fps	视频帧率
data[0].metaData.height	分辨率高，单位：px
data[0].metaData.width	分辨率宽，单位：px
data[0].metaData.codec	编码格式，如h264、h265等
data[0].snapshotInfo.imageUrl	截图url数组

视频状态码	含义
60/61	已发布
10	等待编码
20	正在编码
50	等待审核
51	审核不通过
-1	已删除

java请求示例

public void testGetVideoInfo() {
        String url = "https://api.polyv.net/v3/video/get-video-info";
        // appId和加密串
        String appId = "xxxxxxx";
        String appSecret = "xxxxxxxxxxxxxxxxxx";

        Map<String, String> params = new HashMap<>();
        params.put("vids", "abc,def");
        params.put("filters", "basicInfo,metaData,,transcodeInfo,snapshotInfo");
        // 调用Polyv的工具类方法设置sign
        PolyvTool.setLiveSign(params, appId, appSecret);
        String content = HttpClientUtil.getInstance()
                .sendHttpGet(url + "?" +  PolyvTool.mapJoinNotEncode(params));
        System.out.println(content);
}

签名规则及工具文件代码

https://dev.polyv.net/2020/liveproduct/l-api/rule/live-api-java-detail/

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

修改视频信息

2020年7月30日由钟东东发表

接口URL

https://api.polyv.net/v3/video/update-info

接口说明

(接口调用有频率限制，详细请查看)

1、接口用于修改视频信息
2、接口支持https

请求方式

POST

请求参数

参数名	必选	类型	说明
appId	是	string	子账号appId
timestamp	是	long	当前13位当前时间戳，3分钟有效
sign	是	string	签名值，32位大写MD5值
vid	是	string	视频ID
title	否	string	视频标题
describ	否	string	视频描述
tag	否	string	视频标签信息
publishUrl	否	string	外链地址

响应成功JSON示例：

// 修改成功
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 200,
    "status": "success",
    "error": null,
    "data": null
}

响应失败JSON示例：

// 时间戳错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 100,
        "desc": "invalid timestamp"
    },
    "data": null
}

// appId不正确
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 101,
        "desc": "application not exist"
    },
    "data": null
}

// 子账号不存在
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 102,
        "desc": "user children not exist"
    },
    "data": null
}

// 子账号过期
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 103,
        "desc": "user children expired"
    },
    "data": null
}

// 签名错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 104,
        "desc": "invalid signature"
    },
    "data": null
}

// 账号权限不足
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 105,
        "desc": "permission limited"
    },
    "data": null
}

// 视频vid错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 2000,
        "desc": "invalid vid"
    },
    "data": null
}

// 视频正在上传中
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 3100,
        "desc": "上传中不允许修改"
    },
    "data": null
}

字段说明

字段	说明
requestId	本次请求的ID
code	响应http状态码
status	状态
error.code	错误码
error.desc	错误描述
data	返回数据

java请求示例

public void testUpdateInfo() {
        String url = "https://api.polyv.net/v3/video/update-info";
        // appId和加密串
        String appId = "xxxxxxx";
        String appSecret = "xxxxxxxxxxxxxxxxxx";

        Map<String, String> params = new HashMap<>();
        params.put("vid", "xxx");
        params.put("title", "标题");
        params.put("describ", "描述");
        params.put("tag", "视频标签");
        params.put("publishUrl", "外链地址");

        // 调用Polyv的工具类方法设置sign
        PolyvTool.setLiveSign(params, appId, appSecret);
        String content = HttpClientUtil.getInstance()
                .sendHttpPost(url, params);
        System.out.println(content);
}

签名规则及工具文件代码

https://dev.polyv.net/2020/liveproduct/l-api/rule/live-api-java-detail/

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

查询视频分类

2020年7月30日由钟东东发表

接口URL

https://api.polyv.net/v3/category/get

接口说明

(接口调用有频率限制，详细请查看)

1、接口用于查询视频分类
2、接口支持https

请求方式

GET,POST

请求参数

参数名	必选	类型	说明
appId	是	string	子账号appId
timestamp	是	long	当前13位当前时间戳，3分钟有效
sign	是	string	签名值，32位大写MD5值
cateId	是	long	分类id
page	否	int	子分类列表页码
pageSize	否	int	子分类每页大小

响应成功JSON示例：

// 获取成功
{
    "requestId": "9a98f2aa-a52f-4105-87db-5697744dfcc6",
    "code": 200,
    "status": "success",
    "error": null,
    "data": {
        "category": {
            "cateId": 1594482470001,
            "cateName": "分类名称",
            "parentId": 1
        },
        "subCategoryTotal": 1,
        "subCategories": [
            {
                "cateId": 1616569379561,
                "cateName": "子分类名称",
                "parentId": 1594482470001
            }
        ]
    }
}

响应失败JSON示例：

// 时间戳错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 100,
        "desc": "invalid timestamp"
    },
    "data": null
}

// appId不正确
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 101,
        "desc": "application not exist"
    },
    "data": null
}

// 子账号不存在
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 102,
        "desc": "user children not exist"
    },
    "data": null
}

// 子账号过期
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 103,
        "desc": "user children expired"
    },
    "data": null
}

// 签名错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 104,
        "desc": "invalid signature"
    },
    "data": null
}

// 账号权限不足
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 105,
        "desc": "permission limited"
    },
    "data": null
}

// 分类不存在
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 3001,
        "desc": "category not exist"
    },
    "data": null
}

字段说明

字段	说明
requestId	本次请求的ID
code	响应http状态码
status	状态
error.code	错误码
error.desc	错误描述
data	返回数据
data.category	当前分类
data.category.cateId	分类id
data.category.cateName	分类名称
data.category.parentId	父分类id
data.subCategoryTotal	下一级子分类个数
data.subCategories	下一级子分类列表

java请求示例

public void testGetCategory() {
        String url = "http://api.polyv.net/v3/category/get";
        // appId和加密串
        String appId = "xxxxx";
        String appSecret = "xxxxxxxxxxxxxxxxxxxxxxx";
        long cateId = 1594482470001L;

        Map<String, String> params = new HashMap<>();
        params.put("cateId", String.valueOf(cateId));
        params.put("page", String.valueOf(1));
        params.put("pageSize", String.valueOf(10));
        // 调用Polyv的工具类方法设置sign
        PolyvTool.setLiveSign(params, appId, appSecret);
        String content = HttpClientUtil.getInstance()
                .sendHttpGet(url + "?" + PolyvTool.mapJoinNotEncode(params));
        System.out.println(content);
}

签名规则及工具文件代码

https://dev.polyv.net/2020/liveproduct/l-api/rule/live-api-java-detail/

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

删除视频

2020年7月30日由钟东东发表

接口URL

https://api.polyv.net/v3/video/delete-video

接口说明

(接口调用有频率限制，详细请查看)

1、接口用于删除视频信息
2、接口支持https

请求方式

GET,POST

请求参数

参数名	必选	类型	说明
appId	是	string	子账号appId
timestamp	是	long	当前13位当前时间戳，3分钟有效
sign	是	string	签名值，32位大写MD5值
vid	是	string	视频ID

响应成功JSON示例：

// 删除成功
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 200,
    "status": "success",
    "error": null,
    "data": null
}

响应失败JSON示例：

// 时间戳错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 100,
        "desc": "invalid timestamp"
    },
    "data": null
}

// appId不正确
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 101,
        "desc": "application not exist"
    },
    "data": null
}

// 子账号不存在
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 102,
        "desc": "user children not exist"
    },
    "data": null
}

// 子账号过期
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 103,
        "desc": "user children expired"
    },
    "data": null
}

// 签名错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 104,
        "desc": "invalid signature"
    },
    "data": null
}

// 账号权限不足
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 105,
        "desc": "permission limited"
    },
    "data": null
}

// 视频vid错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 2000,
        "desc": "invalid vid"
    },
    "data": null
}

字段说明

字段	说明
requestId	本次请求的ID
code	响应http状态码
status	状态
error.code	错误码
error.desc	错误描述
data	返回数据

java请求示例

public void testDeleteVideo() {
        String url = "https://api.polyv.net/v3/video/delete-video";
        // appId和加密串
        String appId = "xxxxxxx";
        String appSecret = "xxxxxxxxxxxxxxxxxx";
        String vid = "xx";
        Map<String, String> params = new HashMap<>();
        params.put("vid", vid);
        // 调用Polyv的工具类方法设置sign
        PolyvTool.setLiveSign(params, appId, appSecret);
        String content = HttpClientUtil.getInstance()
                .sendHttpPost(url,params);
        System.out.println(content);
}

签名规则及工具文件代码

https://dev.polyv.net/2020/liveproduct/l-api/rule/live-api-java-detail/

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

搜索视频

2020年7月30日由钟东东发表

接口URL

https://api.polyv.net/v3/video/list-video

接口说明

(接口调用有频率限制，详细请查看)

1、接口用于搜索视频
2、接口支持https

请求方式

GET,POST

请求参数

参数名	必选	类型	说明
appId	是	string	子账号appId
timestamp	是	long	当前13位当前时间戳，3分钟有效
sign	是	string	签名值，32位大写MD5值
cateId	否	long	视频分类ID
title	否	string	按标题搜索
uploader	否	string	上传者
status	否	int	视频状态
containSubCate	否	string	是否包含子分类, Y 包含, N 不包含
startTime	否	long	按创建时间范围查询，起始时间戳，13位时间戳
endTime	否	long	结束时间戳，13位时间戳
page	否	int	页码,默认为1
pageSize	否	int	页面大小,默认为10
sort	否	string	排序creationTimeDesc或creationTimeAsc

响应成功JSON示例：

// 请求成功
{
    "requestId": "652c7f9b-bfc4-4cd1-b58b-b73062bba229",
    "code": 200,
    "status": "success",
    "error": null,
    "data": {
        "pageNumber": 1,
        "totalPages": 65,
        "pageSize": 1,
        "contents": [
            {
                "vid": "a2dc4f2517d7a3b462dc1876c333fd32_a",
                "basicInfo": {
                    "title": "视频标题",
                    "description": "视频秒数",
                    "duration": 732.0,
                    "coverURL": "https://img.videocc.net/uimage/a/a2dc4f2517/2/a2dc4f2517d7a3b462dc1876c333fd32_0_b.jpg",
                    "creationTime": "2021-05-02 09:29:39",
                    "updateTime": "2021-05-02 09:35:12",
                    "size": 61663766,
                    "status": 61,
                    "cateId": 1,
                    "cateName": "默认分类",
                    "tags": "",
                    "uploader": "API"
                }
            }
        ],
        "totalItems": 65
    }
}

响应失败JSON示例：

// 时间戳错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 100,
        "desc": "invalid timestamp"
    },
    "data": null
}

// appId不正确
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 101,
        "desc": "application not exist"
    },
    "data": null
}

// 子账号不存在
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 102,
        "desc": "user children not exist"
    },
    "data": null
}

// 子账号过期
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 103,
        "desc": "user children expired"
    },
    "data": null
}

// 签名错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 104,
        "desc": "invalid signature"
    },
    "data": null
}

// 账号权限不足
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 105,
        "desc": "permission limited"
    },
    "data": null
}

// 无法操作此分类，权限不足
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 106,
        "desc": "category limited"
    },
    "data": null
}

// 分类id不存在
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 3001,
        "desc": "category not exist"
    },
    "data": null
}

字段说明

字段	说明
requestId	本次请求的ID
code	响应http状态码
status	状态
error.code	错误码
error.desc	错误描述
data	返回结果集
data.pageNumber	当前的页数
data.pageSize	每页条数
data.totalItems	总的条数
data.contents	查询的结果列表
data.content[0].vid	视频id
data.contents[0].basicInfo.title	视频标题
data.contents[0].basicInfo.description	视频描述
data.contents[0].basicInfo.duration	源视频时长，单位：秒
data.contents[0].basicInfo.coverURL	首图地址，大图
data.contents[0].basicInfo.creationTime	创建时间
data.contents[0].basicInfo.updateTime	更新时间
data.contents[0].basicInfo.size	源文件大小，单位：Bytes
data.contents[0].basicInfo.status	视频状态码
data.contents[0].basicInfo.cateId	分类id, 如1为根目录
data.contents[0].basicInfo.cateName	分类名称
data.contents[0].basicInfo.tags	标签
data.contents[0].basicInfo.uploader	上传者

视频状态码	含义
60/61	已发布
10	等待编码
20	正在编码
50	等待审核
51	审核不通过
-1	已删除

java请求示例

public void testListVideo() {
        String url = "https://api.polyv.net/v3/video/list-video";
        // appId和加密串
        String appId = "xxxxxxx";
        String appSecret = "xxxxxxxxxxxxxxxxxx";

        long cateId = 1594482470001L;
        Map<String, String> params = new HashMap<>();
        params.put("cateId", String.valueOf(cateId));
        params.put("title", "标题1");
        params.put("uploader", "xxx");
        params.put("status", "60");
        params.put("containSubCate", "Y");
        params.put("page", String.valueOf(1));
        params.put("pageSize", String.valueOf(10));
        params.put("sort", "creationTimeDesc");
        // 调用Polyv的工具类方法设置sign
        PolyvTool.setLiveSign(params, appId, appSecret);
        String content = HttpClientUtil.getInstance()
                .sendHttpGet(url + "?" +  PolyvTool.mapJoinEncode(params));
        System.out.println(content);
}

签名规则及工具文件代码

https://dev.polyv.net/2020/liveproduct/l-api/rule/live-api-java-detail/

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

新增视频分类

2020年7月30日由钟东东发表

接口URL

https://api.polyv.net/v3/category/add

接口说明

(接口调用有频率限制，详细请查看)

1、接口用于新增视频分类
2、接口支持https

请求方式

POST

请求参数

参数名	必选	类型	说明
appId	是	string	子账号appId
timestamp	是	long	当前13位当前时间戳，3分钟有效
sign	是	string	签名值，32位大写MD5值
name	是	string	分类名
parentId	否	long	父分类id, 默认位1, 放在根目录下

响应成功JSON示例：

// 添加分类成功
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 200,
    "status": "success",
    "error": null,
    "data": 1594807635977
}

响应失败JSON示例：

// 时间戳错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 100,
        "desc": "invalid timestamp"
    },
    "data": null
}

// appId不正确
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 101,
        "desc": "application not exist"
    },
    "data": null
}

// 子账号不存在
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 102,
        "desc": "user children not exist"
    },
    "data": null
}

// 子账号过期
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 103,
        "desc": "user children expired"
    },
    "data": null
}

// 签名错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 104,
        "desc": "invalid signature"
    },
    "data": null
}

// 账号权限不足
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 105,
        "desc": "permission limited"
    },
    "data": null
}

// 分类名称不能为空
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 3000,
        "desc": "没有填写栏目名称"
    },
    "data": null
}

// 父分类不能为空
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 3001,
        "desc": "category not exist"
    },
    "data": null
}

// 子账号没有权限在该目录下创建分类
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 3002,
        "desc": "子账号没有权限在该目录下创建分类"
    },
    "data": null
}

{
    "requestId": "df5750d9-27b0-4390-ad7c-f0d1f86d0d14",
    "code": 400,
    "status": "error",
    "error": {
        "code": 3003,
        "desc": "已存在同名的视频分类"
    },
    "data": null
}

字段说明

字段	说明
requestId	本次请求的ID
code	响应http状态码
status	状态
error.code	错误码
error.desc	错误描述
data	返回数据，创建好的分类id

java请求示例

public void testAddCategory() {
        String url = "https://api.polyv.net/v3/category/add";
        // appId和加密串
        String appId = "xxxxxxx";
        String appSecret = "xxxxxxxxxxxxxxxxxx";

        long cataId = 1594482470001L;
        Map<String, String> params = new HashMap<>();
        params.put("name", "name");
        params.put("parentId", String.valueOf(cataId));

        // 调用Polyv的工具类方法设置sign
        PolyvTool.setLiveSign(params, appId, appSecret);
        String content = HttpClientUtil.getInstance()
                .sendHttpPost(url, params);
        System.out.println(content);
}

签名规则及工具文件代码

https://dev.polyv.net/2020/liveproduct/l-api/rule/live-api-java-detail/

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

修改视频分类信息

2020年7月30日由钟东东发表

接口URL

https://api.polyv.net/v3/category/update-info

接口说明

(接口调用有频率限制，详细请查看)

1、接口用于更新视频分类信息
2、接口支持https

请求方式

POST

请求参数

参数名	必选	类型	说明
appId	是	string	子账号appId
timestamp	是	long	当前13位当前时间戳，3分钟有效
sign	是	string	签名值，32位大写MD5值
cateId	是	long	分类id
cateName	是	string	分类名称

响应成功JSON示例：

// 修改成功
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 200,
    "status": "success",
    "error": null,
    "data": null
}

响应失败JSON示例：

// 时间戳错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 100,
        "desc": "invalid timestamp"
    },
    "data": null
}

// appId不正确
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 101,
        "desc": "application not exist"
    },
    "data": null
}

// 子账号不存在
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 102,
        "desc": "user children not exist"
    },
    "data": null
}

// 子账号过期
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 103,
        "desc": "user children expired"
    },
    "data": null
}

// 签名错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 104,
        "desc": "invalid signature"
    },
    "data": null
}

// 账号权限不足
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 105,
        "desc": "permission limited"
    },
    "data": null
}

// 无法操作此分类，权限不足
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 106,
        "desc": "category limited"
    },
    "data": null
}

// 分类id不存在
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 3001,
        "desc": "category not exist"
    },
    "data": null
}

字段说明

字段	说明
requestId	本次请求的ID
code	响应http状态码
status	状态
error.code	错误码
error.desc	错误描述
data	返回数据

java请求示例

public void testUpdateCategory() {
        String url = "https://api.polyv.net/v3/category/update-info";
        // appId和加密串
        String appId = "xxxxxxx";
        String appSecret = "xxxxxxxxxxxxxxxxxx";
        long cataId = 1594482470001L;
        Map<String, String> params = new HashMap<>();
        params.put("cateId", String.valueOf(cataId));
        params.put("cateName", "好的呢");

        // 调用Polyv的工具类方法设置sign
        PolyvTool.setLiveSign(params, appId, appSecret);
        String content = HttpClientUtil.getInstance()
                .sendHttpPost(url,params);
        System.out.println(content);
}

签名规则及工具文件代码

https://dev.polyv.net/2020/liveproduct/l-api/rule/live-api-java-detail/

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

删除视频分类

2020年7月30日由钟东东发表

接口URL

https://api.polyv.net/v3/category/delete

接口说明

(接口调用有频率限制，详细请查看)

1、接口用于删除视频信息
2、接口支持https

请求方式

POST

请求参数

参数名	必选	类型	说明
appId	是	string	子账号appId
timestamp	是	long	当前13位当前时间戳，3分钟有效
sign	是	string	签名值，32位大写MD5值
cateId	是	string	视频分类ID

响应成功JSON示例：

// 删除成功
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 200,
    "status": "success",
    "error": "",
    "data": null
}

响应失败JSON示例：

// 时间戳错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 100,
        "desc": "invalid timestamp"
    },
    "data": null
}

// appId不正确
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 101,
        "desc": "application not exist"
    },
    "data": null
}

// 子账号不存在
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 102,
        "desc": "user children not exist"
    },
    "data": null
}

// 子账号过期
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 103,
        "desc": "user children expired"
    },
    "data": null
}

// 签名错误
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 104,
        "desc": "invalid signature"
    },
    "data": null
}

// 账号权限不足
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 403,
    "status": "error",
    "error": {
        "code": 105,
        "desc": "permission limited"
    },
    "data": null
}

// 无法操作此分类，权限不足
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 106,
        "desc": "category limited"
    },
    "data": null
}

// 删除分类失败，原因有：cataid不合法、顶层分类不允许删除...
{
    "requestId": "5ede3d23-45f0-4661-99be-e95d07daf049",
    "code": 400,
    "status": "error",
    "error": {
        "code": 3004,
        "desc": "delete category failed"
    },
    "data": null
}

字段说明

字段	说明
requestId	本次请求的ID
code	响应http状态码
status	状态
error.code	错误码
error.desc	错误描述
data	返回数据

java请求示例

public void testDeleteVideoCategory() {
        String url = "https://api.polyv.net/v3/category/delete";
        // appId和加密串
        String appId = "xxxxxxx";
        String appSecret = "xxxxxxxxxxxxxxxxxx";
        long cateId = 1594807635977L;
        Map<String, String> params = new HashMap<>();
        params.put("cateId", String.valueOf(cateId));
        // 调用Polyv的工具类方法设置sign
        PolyvTool.setLiveSign(params, appId, appSecret);
        String content = HttpClientUtil.getInstance()
                .sendHttpPost(url,params);
        System.out.println(content);
}

签名规则及工具文件代码

https://dev.polyv.net/2020/liveproduct/l-api/rule/live-api-java-detail/

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