按云会议号分页获取视频列表

功能说明

查询企业下某个会议室的视频列表，录制开始时间在某个时间段内的录制视频可以获取到。

默认接口请求频率限制：20次/秒

实现方法

REST URL

PUT https://sdk.xylink.com/api/rest/external/{version}/meetingroom/vods/page?enterpriseId=XXX&pageIndex=XXX&pageSize=XXX&signature=XXX

请求参数说明:

参数	参数类型	参数位置	必须	默认值	说明	初始平台
version	String	Path	是	无	传v1即可	3.9无此接口
enterpriseId	String	Query	是	无	企业ID，通过管理平台-云视讯API获得
signature	String	Query	签名鉴权1.0（旧）：是签名鉴权2.0：否	无	API签名，参考签名鉴权
startTime	Long	Body	否	无	录制开始时间，Unix时间戳（毫秒数）【如果startTime和endTime都不传，则默认查询所有】	5.2
endTime	Long	Body	否	无	录制结束时间 Unix时间戳（毫秒数）【如果startTime和endTime都不传，则默认查询所有】	5.2
vodMetadataType	String	Query	否	无	录制类型（ SERVER_RECORD云端录制， AUDIO_RECORD音频录制）
meetingRoomNumbers	Arrays of String	Body	是	无	云会议室号列表：最大50	5.2
pageIndex	int	Query	否	0	页码：从0开始	5.2
pageSize	int	Query	否	10	每页查询数量：最大100	5.2

示例代码

请求示例

请求消息体示例（Json）

{
  "meetingRoomNumbers": [
    "9000637027",
    "9000637028"
  ],
  "startTime": "1626262822213",
  "endTime": "1660790215347"
}

结果示例

请求成功返回结果示例

{
    "page": 0,
    "pageTotal": 1,
    "rowsTotal": 2,
    "rows": 2,
    "list": [
        {
           "vodId": 1, 
           "displayName": "16/07/29 11:40",
           "startTime": 1658913536438,
           "endTime": 1658913587874,
           "fileSize": 1231223432,
           "meetingRoomNumber": "9001267192",
           "nemoNumber": null, 
           "vodMetadataType":"SERVER_RECORD",
           "thumbnailUrl": "http://prdvoddownload.xylink.com/vodfiles/vodfiles/cloud/919005219132/101-bj1-prdSig1-11693968062538_0_1643334674053_1280_720_mini.jpg?auth_key=1641447779-0-0-f2312375383838aa935cb7659a8ecfwddd897f",
           "transcriptionId": "968099157de54262191de609d6d20000",
           "transcriptionTxtFileUrl": "http://prdvoddownload.xylink.com/transcription/104-bj1-preSig1-1162047817320-1640241936179/21_12_23_14_45_36.txt?auth_key=1640943297-0-0-0b81c6b0a1293946bb47379ab30f01c6"
        }
    ]
}

返回参数说明:

参数名称	说明
page	当前页
pageTotal	总页数
rowsTotal	总条数
rows	当前页的条数
vodId	视频的ID
displayName	视频的默认名称，一般为时间
startTime	录制的开始时间 UNIX时间毫秒
endTime	录制的结束时间 UNIX时间毫秒
fileSize	文件大小，单位字节
meetingRoomNumber	云会议室录制的云会议号，如果是小鱼录制，则为空
nemoNumber	小鱼录制的小鱼号
thumbnailUrl	视频缩略图下载链接
vodMetadataType	LOCAL_RECORD(本地小鱼录像机录制),SERVER_RECORD(会议录制),LIVE_RECORD(直播录制),SERVER_EDIT_RECORD(剪辑状态),SERVER_RECORD_TRANSCODING(会议录制转码中，此状态下不能播放、下载视频文件，24小时内处理完成后才可以播放、下载
transcriptionId	会议纪要id
transcriptionTxtFileUrl	会议纪要下载链接

请求失败结果示例

{
    "developerMessage": "ErrorStatus: SDK_INVALID_APPKEY No app found for extId: ",
    "userMessage": "sdk.invalid.key",
    "errorCode": 60001,
    "moreInfo": "http://www.com.ainemo.com/errors/60001"
}

错误码

错误码见小鱼RESTAPI错误码

2024-05-13 18:51:06

导出PDF文档