保利威文档中心

幫助中心

點播影片CDN刷新與預熱

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

介面URL

https://api.polyv.net/v2/video/refresh-cdn-cache

介面說明

1. 点播视频CDN刷新预热,目前仅支持预热点播zip文件
2. 提交任务后,需 5-10 分钟左右才能生效
3. 同一个用户,每天最多刷新预热 2000 个文件

請求方式

1. 支持POST请求,参数需放在请求体中,并以form表单的形式提交
2. Content-Type: application/x-www-form-urlencoded

請求參數

參數名 必選 類型及範圍 說明
userid true string 用戶ID
ptime true long 13位當前時間的毫秒級時間戳
sign true String 簽名,為40位大寫的SHA1值【詳見簽名生成規則
action true string 執行操作,預熱:"push"
fileType true string 檔案類型,點播影片zip檔案:"zip"
videos true array 影片資訊陣列,格式為json字串,每次請求的數量不能超過100個
videos[0].vid true string 影片ID
videos[0].brIndex true int 碼率序號,1:流暢,2:高清,3:超清

videos 參數範例

[
    {
    "vid": "e6b23c6f513fbe025b94efdd10d7ab47_e",
    "brIndex": 1
    },
    {
    "vid": "e6b23c6f513fbe025b94efdd10d7ab47_e",
    "brIndex": 2
    },
    {
    "vid": "e6b23c6f513fbe025b94efdd10d7ab47_e",
    "brIndex": 3
    }
]

回傳結果

JSON範例

上传成功返回示例
{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": {
        "taskId": "b3ad461ef1df4afc9340427767968a4c"
    }
}

請求失敗回傳json範例

时间戳过期
{
    "code": 400,
    "status": "error",
    "message": "ptime is too old",
    "data": null
}
签名不正确
{
    "code": 400,
    "status": "error",
    "message": "the sign is not right.",
    "data": null
}
提交的vid中存在不合法值
{
    "code": 400,
    "status": "error",
    "message": "illeagal vid",
    "data": null
}
每次提交不能超过100个文件
{
    "code": 400,
    "status": "error",
    "message": "can't submit more than 100 files",
    "data": null
}
码率不存在
{
    "code": 400,
    "status": "error",
    "message": "bitrate does not exist",
    "data": null
}
每天不能提交超过2000个文件
{
    "code": 400,
    "status": "error",
    "message": "can't submit more than 2000 files one day",
    "data": null
}

欄位說明

欄位 說明
code 請求回傳狀態碼
status 請求回傳狀態
message 請求回傳資訊
data 回傳資料
data.taskId 任務ID

java請求範例

public void testRefreshCdnCache() {
        String url = "https://api.polyv.net/v2/video/refresh-cdn-cache";
        String userid = "xxxxxxx";
        String vid = "xxxxxxxxxxxxxxxxxxxx";
        String secretkey = "xxxxxxx";
        String videos = "[{\"vid\": \"e6b23c6f513fbe025b94efdd10d7ab47_e\",\"brIndex\": 1}]";
        long ptime = System.currentTimeMillis();

        Map<String, String> params = new HashMap<>();
        params.put("ptime", String.valueOf(ptime));
        params.put("userid", userid);
        params.put("videos", videos);
        params.put("action", "push");
        params.put("fileType", "zip");
        params.put("sign", getSign(params, secretkey));
        String content = HttpClientUtil.getInstance().sendHttpPost(url, params);
        System.out.println(content);
}
联系客服,在线咨询