通过视频id查询单个视频的信息
接口地址(仅做说明使用):https://api.polyv.net/v2/video/%s/get-video-msg
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
@Test
public void testGetVideo() throws IOException, NoSuchAlgorithmException {
VodGetVideoRequest vodGetVideoRequest = new VodGetVideoRequest();
VodGetVideoResponse vodGetVideoResponse = null;
try {
vodGetVideoRequest.setVideoId(super.getTestVideoId());
vodGetVideoResponse = new VodInfoServiceImpl().getVideo(vodGetVideoRequest);
Assert.assertNotNull(vodGetVideoResponse);
if (vodGetVideoResponse != null) {
log.debug("测试查询单个视频信息成功,{}", JSON.toJSONString(vodGetVideoResponse));
}
} catch (PloyvSdkException e) {
//参数校验不合格 或者 请求服务器端500错误,错误信息见PloyvSdkException.getMessage()
log.error(e.getMessage(), e);
// 异常返回做B端异常的业务逻辑,记录log 或者 上报到ETL 或者回滚事务
throw e;
} catch (Exception e) {
log.error("SDK调用异常", e);
throw e;
}
}
1、请求正确,返回VodGetVideoResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
返回flash链接【对应api文档的swf_link字段】
视频宽度【对应api文档的playerwidth字段】
视频首图【对应api文档的first_image字段】
最佳分辨率,如:1280x720【对应api文档的original_definition字段】
视频高度【对应api文档的playerheight字段】
上传时间,格式:yyyy-MM-dd HH:mm:ss【对应api文档的ptime字段】
预览视频id【对应api文档的previewVid字段】
分类id, 如1为根目录【对应api文档的cataid字段】
用户默认播放视频【对应api文档的default_video字段】
流畅码率flv格式视频地址【对应api文档的flv1字段】
高清码率flv格式视频地址【对应api文档的flv2字段】
超清码率flv格式视频地址【对应api文档的flv3字段】
流畅码率mp4格式视频地址【对应api文档的mp4_1字段】
高清码率mp4格式视频地址【对应api文档的mp4_2字段】
超清码率mp4格式视频地址【对应api文档的mp4_3字段】
索引文件,记录每个清晰度的m3u8的链接,数组第一个为流畅链接,第二个为高清,第三个为超清,数组长度为1-3
视频截图大图地址【对应api文档的images_b字段】
视频状态:60/61已发布;10等待编码;20正在编码;50等待审核;51审核不通过;-1已删除;
是否为源文件,否:0,是:1【对应api文档的keepsource字段】
加密等级 open:非授权加密 web:web授权 app:app授权 wxa_app:小程序授权
源视频文件大小,单位为:byte【对应api文档的source_filesize字段】
上传到POLYV云平台的视频源文件的MD5值,可以用来校验是否上传错误或完整【对应api文档的md5checksum字段】
Uploader参数描述
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回Boolean对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
true为开关开启,false为开关关闭
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
2、当传了videoIds时,按照videoIds查询;当仅传categoryIds时,按照categoryIds查询;videoIds和categoryIds不能同时为空;同时传以videoIds为准
1、请求正确,返回VodGetVideoSizeResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
多个视频ID(英文逗号分割 状态为半角),例如 1b8be3,239c2e【对应api文档的vids字段】
多个分类ID(逗号分割),当传了vids时,按照vids查询;当仅传cataid时,按照cataid查询;vids和cataid不能同时为空【对应api文档的cataid字段】
返回对象是List<VodGetVideoSizeResponse>,VodGetVideoSizeResponse具体元素内容如下:
Video参数描述
时长,格式为hh:mm:ss。例如 00:03:11
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回VodGetWeChatShareVideoInfoResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回Integer对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
视频播放预览时长,单位:秒
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回String对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
是否为视频首图的缩略图,值为1:是;值为0:否。默认为0:非视频首图的缩略图【对应api文档的t字段】
首图地址
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回VodQueryVideoPasswordResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回VodGetVideosPlayTimesResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
多个视频ID(英文逗号分割 状态为半角),建议不超过200个,例如 1b8be3,239c2e【对应api文档的vids字段】
是否实时,1表示实时,0表示非实时,默认为0:非实时
返回对象是List<VodGetVideosPlayTimesResponse>,VodGetVideosPlayTimesResponse具体元素内容如下:
1、接口调用有频率限制,详细请查看,调用常见异常,详细请查看
1、请求正确,返回VodAccountQueryVideoInfoResponse对象,B端依据此对象处理业务逻辑;
2、请求参数校验不合格,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 输入参数 [xxx.chat.VodxxxRequest]对象校验失败,失败字段 [pic不能为空 / msg不能为空] ]
3、服务器处理异常,抛出PloyvSdkException,错误信息见PloyvSdkException.getMessage(),如 [ 保利威请求返回数据错误,请求流水号:66e7ad29fd04425a84c2b2b562d2025b,错误原因: invalid signature. ]
视频id(可以支持多个,用英文逗号隔开)【对应api文档的vid字段】
返回对象是List<VodAccountQueryVideoInfoResponse>,VodAccountQueryVideoInfoResponse具体元素内容如下:
BasicInfo参数描述
创建时间,格式:yyyy-MM-dd HH:mm:ss
更新时间,格式:yyyy-MM-dd HH:mm:ss
视频状态码;60/61:已发布;10:等待编码;20:正在编码;50:等待审核;51:审核不通过;-1:已删除;
分类id, 如1为根目录【对应api文档的cateId字段】
TranscodeInfos参数描述
清晰度,SOURCE:原清晰度,LD:普清,SD:标清,HD:高清
视频状态, normal:可以正常播放,unavailable:不能正常播放
MetaData参数描述
SnapshotInfo参数描述