查询课节回放视频
更新时间：2024-10-21 09:33:43
接口描述
1、查询课节回放视频
2、接口支持https协议
接口URL
https://api.polyv.net/hi-class-api/open/lesson/v1/getPlaybackVideo
请求方式
GET
接口约束
1、接口同时支持HTTP 、HTTPS ，建议使用HTTPS 确保接口安全，接口调用有频率限制，详细请查看
请求参数描述
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | true | String | 账号appId【详见获取密钥】 |
| timestamp | true | Long | 当前13位毫秒级时间戳，3分钟内有效 |
| sign | true | String | 签名，为32位大写的MD5值【详见签名生成规则】 |
| lessonId | true | Long | 课节号 |
示例
http://api.polyv.net/hi-class-api/open/lesson/v1/getPlaybackVideo?appId=fyirmfdak4×tamp=1638782295111&sign=4FFEE70C353D7F97F9D9057A8A72E453&lessonId=1015
响应参数描述
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | Integer | 响应状态码，200为成功返回，非200为失败【详见全局错误说明】 |
| status | String | 响应状态文本信息 |
| error | Error | 错误对象【详见全局错误说明】 |
| data | Array | 请求失败时为空，请求成功时为响应信息 【详见data字段描述】 |
data字段描述
| 参数名 | 类型 | 说明 |
|---|---|---|
| lessonId | Long | 课节ID |
| lessonName | String | 课节名称 |
| firstImage | String | 首屏截图 |
| duration | String | 视频时长，格式 HH:mm:ss |
| vid | String | 视频id |
| status | Long | 视频状态码 60/61：已发布 10：等待编码 20：正在编码 40：编码失败 50：等待审核 51：审核不通过 |
| createTime | String | 视频创建时间 yyyy-MM-dd HH:mm:ss |
| videoSize | Long | 视频文件大小，单位：Bytes |
| playTimes | String | 播放次数 |
| url | String | 视频链接 |
Java请求示例
快速接入基础代码请下载相关依赖源码， 点击下载源代码 ,下载后加入到自己的源码工程中即可。测试用例中的HttpUtil.java 和 LiveSignUtil.java 都包含在下载文件中。
/**
* 查询课节回放视频
* @throws IOException
* @throws NoSuchAlgorithmException
*/
@Test
public void getPlaybackVideo() throws IOException, NoSuchAlgorithmException {
//公共参数,填写自己的实际参数
String appId = super.appId;
String appSecret = super.appSecret;
String userId = super.userId;
String timestamp = String.valueOf(System.currentTimeMillis());
//业务参数
String url = "https://api.polyv.net/hi-class-api/open/lesson/v1/getPlaybackVideo";
String lessonId = "1015";
//http 调用逻辑
Map<String,String> requestMap = new HashMap<>();
requestMap.put("appId", appId);
requestMap.put("timestamp",timestamp);
requestMap.put("lessonId",lessonId);
requestMap.put("sign",LiveSignUtil.getSign(requestMap, appSecret));
String response = HttpUtil.get(url, requestMap);
log.info("查询课节回放视频：{}",response);
//do somethings
}
响应示例
系统全局错误说明详见全局错误说明
成功示例
{
"code": 200,
"status": "success",
"data": [
{
"lessonId": "1015",
"lessonName": "课节1015",
"firstImage": "//s1.videocc.net/default-img/small-class/default-cover.png",
"duration": "00:00:36",
"vid": "43f5f9caa2028deb711233444540e5964_4",
"status": "61",
"createTime": "2021-11-08 10:21:32",
"videoSize": 1095207,
"playTimes": "0",
"url": "http://mpv.videocc.net/43f5f9caa2/4/43f5f9caa2028deb711233444540e5964_4.mp4"
}
],
"success": true
}
异常示例
{
"code": 400,
"status": "error",
"error": {
"code": 20012,
"desc": "课节不存在"
},
"data": null,
"success": false
}
