查询普通合流回放列表
更新时间:2022-12-28
接口描述
通过该接口可以分页查询普通回放列表的信息
说明:直播结束后预计10-15分后可生成回放
请求地址
https://api.csslcloud.net/api/v2/record/info
请求方式
GET
请求参数
接口统一权限认证请参考THQS认证方式。
名称 |
类型 |
必填 |
描述 |
roomid |
String |
是 |
直播间ID |
userid |
String |
是 |
开发者账号ID |
pagenum |
Integer |
否 |
每页记录条数,默认50。取值范围:1~500之前的任意整数 |
pageindex |
Integer |
否 |
第几页,默认1。取值范围:大于1的整数 |
starttime |
String |
否 |
查询开始时间(按开始录制时间查询),如果填写该参数则endtime参数必填,示例:"2022-12-01 12:30" |
endtime |
String |
否 |
查询结束时间(按开始录制时间查询),如果填写该参数则starttime参数必填,示例:"2022-12-02 12:30" |
liveid |
String |
否 |
直播ID ,填写该参数后只查询该直播下的回放 |
请求示例
GET https://api.csslcloud.net/api/v2/record/info?userid=6D758EEDBFD5FC873&roomid=F05392A0BC8E88F99C33DC5901307461&pagenum=50&pageindex=1&time=1669877322&hash={hash}
返回数据
名称 |
类型 |
描述 |
result |
String |
返回状态,"OK":成功,“FAIL”:失败 |
count |
Integer |
总的回放记录条数 |
pageIndex |
Integer |
当前第几页 |
records |
Array |
回放列表信息 |
records说明
名称 |
类型 |
描述 |
id |
String |
回放ID |
liveId |
String |
直播ID |
startTime |
String |
开始录制时间, 格式为"yyyy-MM-dd HH:mm:ss" |
stopTime |
String |
结束录制时间, 格式为"yyyy-MM-dd HH:mm:ss", 如果录制未结束,该值则为空字符串("") |
recordStatus |
Integer |
录制状态:0为录制未结束,1为录制完成 |
recordVideoId |
String |
录制视频ID,如果recordStatus返回为0,则该值返回-1 |
replayUrl |
String |
回放地址,如果recordStatus返回0则该值返回空字符传("") |
offlinePackageUrl |
String |
离线包下载地址,协议类型HTTP,只有开通了离线包权限才会返回该字段。 |
offlinePackageMd5 |
String |
离线包md5,只有开通离线包权限才会返回该字段 |
sourceType |
Integer |
回放来源:0为录制, 1为合并, 2为迁移, 3为上传 |
title |
String |
直播间名称 |
desc |
String |
直播间描述 |
templateType |
Integer |
模版类型:1为视频直播, 2为视频直播+聊天互动+直播问答,3为视频直播+聊天互动, 4为视频直播+聊天互动+直播文档 5为视频直播+聊天互动+直播文档+直播问答,6为视频直播+直播问答 |
返回示例
{
"result": "OK",
"pageIndex": 1,
"count": 1,
"records": [
{
"id": "66CDD51A0005C2F39C33DC5901307461",
"liveId": "26758CD5FD2E3AE79C33DC5901307461",
"startTime": "2022-12-01 13:30:04",
"stopTime": "2022-12-01 13:57:38",
"recordStatus": 1,
"recordVideoStatus": 3,
"recordVideoId": "5DA09164377F335C7E6C9CEE8B422289",
"replayUrl": "https://view.csslcloud.net/api/view/callback?roomid=F05392A0BC8E88F99C33DC5901307461&userid=6D758EEDBFD5FC87&liveid=26758CD5FD2E3AE79C33DC5901307461&recordid=66CDD51A0005C2F39C33DC5901307461",
"templateType": 4,
"sourceType": 0,
"title": "Jed Manlapaz:2022-12-01 13:30-13:55",
"desc": "实时课堂直播间"
}
]
}