上传指定时间点的视频截图
接口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位当前时间的毫秒级时间戳
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);
}
Last updated
Was this helpful?