上传指定时间点的视频截图

接口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请求示例
```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);

}