上傳指定時間點的影片截圖

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

介面URL

https://api.polyv.net/v2/video/upload-image-in-position

介面說明

上传指定时间点的视频截图, 如果时间点对应的图片已存在，则会返回旧图片路径

請求方式

POST
Content-Type:multipart/form-data;

請求參數

參數名	必填	類型及範圍	說明
userid	true	string	使用者ID
ptime	true	long	13位當前時間的毫秒級時間戳
sign	true	String	簽名，為40位大寫的SHA1值【詳見簽名生成規則】
vid	true	string	影片vid
position	true	int	截圖位置（影片的時間點），單位：秒
imageFile	true	file	圖片檔案，大小不能超過5M，該參數不參與簽名

返回結果

JSON範例

上传成功
{
    "code": 200,
    "status": "success",
    "message": "success",
    "data": {
        "vid": "a2dc4f2517dadf1bb312be765089e860_a"
        "position": 10,
        "imageUrl": "http://ab-upload.polyv.net/test/polyv.jpg",
        "exists": 0
    }
}

請求失敗返回json範例

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

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

图片大小不能超过5M
{
    "code": 400,
    "status": "error",
    "message": "ImageFile size can’t more than 5M",
    "data": null
}

欄位說明

欄位	說明
code	請求返回狀態碼
status	請求返回狀態
message	請求返回訊息
data	請求返回資料
imageUrl	圖片存取url
vid	影片vid
position	截圖位置（影片的時間點），單位：秒
exists	該時間點的圖片是否存在，1：已經存在，0：不存在

java請求範例

public void testUploadPositionImage() {
        String url = "https://api.polyv.net/v2/video/upload-image-in-position";
        String userid = "xxxxxxx";
        String vid = "xxxxxxxxxxxxxxxxxxxx";
        int position = 10;
        String secretkey = "xxxxxxx";
        long ptime = System.currentTimeMillis();

        Map<String, String> params = new HashMap<>();
        params.put("position", String.valueOf(position));
        params.put("ptime", String.valueOf(ptime));
        params.put("userid", userid);
        params.put("vid", "xxx");
        params.put("sign", getSign(params, secretkey));
        String content = HttpClientUtil.getInstance().sendHttpPost(url, params);
        System.out.println(content);
}