上傳影片封面圖

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

介面URL

http://api.polyv.net/v2/video/upload-cover-image

介面說明

上傳影片封面圖

支援格式

JSON

請求方式

POST

請求參數

參數名	必選	類型及範圍	說明
userid	是	string	使用者id
ptime	是	long	當前時間的毫秒級時間戳（13位），3分鐘內有效
sign	是	String	簽名，為40位大寫的SHA1值【詳見簽名生成規則】
vids	否	string	影片id，多個影片id用逗號隔開
cateIds	否	string	分類id，多個分類id用逗號隔開
imageFile	否	file	圖片二進位資料
imageUrl	否	string	圖片http url
imageBase64	否	string	圖片資料的base64形式，需加上對應的類型，如data:image/jpg;base64,VBORw0KGgoAAAANSUhEUgAABGwAAAJ3CAYAAADBMcc+AAAAAXNSR0IArs4c6QAAAARnQU1BAACx

參數說明：

vids,cateIds：當傳了vids參數，以vids為準，當vids不傳，以cateIds為準，兩個參數不能同時為空。 imageFile,imageUrl,imageBase64：圖片上傳形式，三者任選其一即可，傳了多個則按imageFile,imageUrl,imageBase64順序選取第一個不為空的形式，注意：圖片格式僅支援png、jpg、jpeg、gif、bmp，且圖片大小不得超過5MB。

返回正確結果JSON範例

{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": {
        "imageUrlSmall": "http://img.videocc.net/uimage/a/a2dc4f2517/first_image/a5bdfab0-43f6-466f-b4b5-c7b54c03277d_s.png",
        "imageUrlBig": "http://img.videocc.net/uimage/a/a2dc4f2517/first_image/a5bdfab0-43f6-466f-b4b5-c7b54c03277d_b.png"
    }
}

返回錯誤結果JSON範例

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

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

内部错误，或传了非法参数程序转换异常
{
    "code": 500,
    "status": "fail",
    "message": "undefined error",
    "data": null
}

欄位說明

欄位	說明
code	回傳碼
status	回傳狀態
message	回傳資訊
data	操作結果
imageUrlSmall	小圖url
imageUrlBig	大圖url

java請求範例：

    public void testUploadCoverImage() throws Exception {
        String url = "http://api.polyv.net/v2/video/upload-cover-image";
        Map<String, String> params = new HashMap<>();
        params.put("userid", userid);
        params.put("vids", "a2dc4f25172872650e7d5c1b8026b13c_a");
        params.put("imageUrl", "https://s1-test.videocc.net/reg-login/img/4477595.png");
        params.put("ptime", String.valueOf(System.currentTimeMillis()));
        params.put("sign", getSign(params, secretkey));
        String response = HttpClientUtil.getInstance().sendHttpPost(url, params);
        System.out.println(response);
    }