上传视频封面图

更新时间：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);
    }

POLYV 帮助中心