查询视频信息

接口URL

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

接口说明

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

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

请求方式

GET,POST

请求参数

响应成功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
}

字段说明

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/