删除视频

接口描述

1、通过视频id删除视频，支持批量删除
2、接口支持https协议

接口URL

http://api.polyv.net/v2/video/del-videos

请求方式

POST

接口约束

1、接口同时支持HTTP 、HTTPS ，建议使用HTTPS 确保接口安全，接口调用有频率限制，

请求参数描述

参数名

必选

类型

说明

userId

true

String

ptime

true

Long

当前时间的毫秒级时间戳，3分钟内有效

sign

true

String

vids

true

String

视频id，多个视频以英文逗号隔开，一次最多提交500个

deleteType

false

String

删除方式，默认为1 1：删除到回收站 2：彻底删除

ignoreInvalidVids

false

String

是否忽略错误视频ID，值为Y或N。默认为N Y：忽略错误的视频ID，正确的视频ID会正常进行处理； N：如果存在错误视频ID，则不进行任何删除操作，返回错误信息；

示例

http://api.polyv.net/v2/video/del-videos

表单参数：

vids=1b448be323e6eee0484ad35a4b55b96d_1,1b448be323e131655fe4a70cc01fd490_1&sign=CDF38C1476AF7578A55D81FB8B4162BD29F9FE53&userId=1b448be323&ptime=1617097496305

响应参数描述

参数名

类型

说明

code

Integer

status

String

响应状态文本信息

message

String

响应描述信息，当code为400或者500的时候，辅助描述错误原因

data

String

如果 ignoreInvalidVids 参数值为Y，且参数中包含错误的视频ID，则 data 中会包含错误的视频ID列表；否则，data 值为空字符串。

Java请求示例

 private static final Logger log = LoggerFactory.getLogger(VodVideoManagementTest.class);
/**
 * 删除视频
 */
@Test
public void testDeleteVideo() throws Exception, NoSuchAlgorithmException {
    //公共参数,填写自己的实际参数
    String secretKey = super.secretKey;
    String userId = super.userId;
    String ptime = String.valueOf(System.currentTimeMillis());
    //业务参数
    String url = "http://api.polyv.net/v2/video/del-videos";
    String vids = "1b448be323e6eee0484ad35a4b55b96d_1,1b448be323e131655fe4a70cc01fd490_1";

    Map<String, String> requestMap = new HashMap<>();
    requestMap.put("userId", userId);
    requestMap.put("ptime", ptime);
    requestMap.put("vids", vids);

    requestMap.put("sign", VodSignUtil.getSign(requestMap, secretKey));
    String response = HttpUtil.postFormBody(url, requestMap);
    log.debug("测试删除视频,{}", response);
    //do somethings
}

响应示例

成功示例

{
	"code": 200,
	"status": "success",
	"message": "success",
	"data": ""
}

异常示例

签名不正确

{
    "code":400,
    "status":"error",
    "message":"the sign is not right",
    "data":""
}

时间戳过期

{
    "code":400,
    "status":"error",
    "message":"ptime is too old.",
    "data":""
}

参数为空

{
    "code":400,
    "status":"error",
    "message":"xxx is empty",
    "data":""
}

删除视频一次最多只能提交500个

{
    "code":400,
    "status":"error",
    "message":"delete vids size can't greater than 500 once",
    "data":""
}

Previous批量查询视频时长和大小 Next查询视频预览时长

Last updated 5 months ago

Was this helpful?

private static final Logger log = LoggerFactory.getLogger(VodVideoManagementTest.class); /** * 删除视频 */ @Test public void testDeleteVideo() throws Exception, NoSuchAlgorithmException { //公共参数,填写自己的实际参数 String secretKey = super.secretKey; String userId = super.userId; String ptime = String.valueOf(System.currentTimeMillis()); //业务参数 String url = "http://api.polyv.net/v2/video/del-videos"; String vids = "1b448be323e6eee0484ad35a4b55b96d_1,1b448be323e131655fe4a70cc01fd490_1"; Map<String, String> requestMap = new HashMap<>(); requestMap.put("userId", userId); requestMap.put("ptime", ptime); requestMap.put("vids", vids); requestMap.put("sign", VodSignUtil.getSign(requestMap, secretKey)); String response = HttpUtil.postFormBody(url, requestMap); log.debug("测试删除视频,{}", response); //do somethings }