取得分類下影片的總計資訊

更新時間：2022-05-23 19:02:59

介面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);
    }