保利威文档中心

帮助中心

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

更新时间: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);
}
联系客服,在线咨询