获取分类下视频的总计信息

接口URL

http://api.polyv.net/v2/cata/total-stats

接口说明

获取分类下视频的总计信息,数据有10分钟延迟

支持格式

JSON

请求方式

GET

请求数限制

TRUE

请求参数

参数名必选类型及范围说明

userid

true

string

用户ID

cataid

false

long

分类ID, 如 1 为默认分类,不传则查询整个用户下的总计信息

containSubCata

false

boolean

是否包含子分类, true: 包含,false:不包含

ptime

true

long

当前13位毫秒级时间戳,3分钟内有效

sign

true

String

签名,为40位大写的SHA1值【详见签名生成规则

JSON示例

{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": {
        "videoNum": 28,
        "usedSpace": 673027885
    }
}

返回错误json

签名不正确
{
"code":400,
"status":"error",
"message":"the sign is not right",
"data":""
}
时间戳过期
{
"code":400,
"status":"error",
"message":"ptime is too old.",
"data":""
}
不合法的分类ID
{
"code":400,
"status":"error",
"message":"illegal cataid",
"data":""
}

字段说明

字段说明

code

请求返回状态码

status

请求返回状态

message

请求返回信息

data

返回数据

videoNum

int 分类下的视频总数

usedSpace

long 分类下视频占用的总空间,单位为bytes

java请求示例

@Test
    public void testGetCataTotalStats() throws Exception {
        String url = "http://api.polyv.net/v2/cata/total-stats";
        String userid = "xxxxxxxxxx";
        long cataid = 1L;
        String secretkey = "xxxxxxxxxx";
        Map<String, String> params = new HashMap<>();
        params.put("userid", userid);
        params.put("cataid", String.valueOf(cataid));
        params.put("containSubCata", String.valueOf(true));
        params.put("ptime", String.valueOf(System.currentTimeMillis()));
        params.put("sign", getSign(params, secretkey));
        String response = HttpClientUtil.getInstance().sendHttpGet(url + "?" + PolyvTool.mapJoinNotEncode(params));
        System.out.println(response);
    }

Last updated