获得企业某段时间内的视频列表,时间跨度最大一天。
默认接口请求频率限制:20次/秒
REST URL
GET https://sdk.xylink.com/api/rest/external/{version}/vods/page?enterpriseId=XXX&startTime=XXX&endTime=XXX&pageIndex=XXX&pageSize=XXX&signature=XXX
请求参数说明:
参数 | 参数类型 | 参数位置 | 必须 | 默认值 | 说明 | 初始平台 |
version | String | Path | 是 | 无 | 传v1即可 | |
enterpriseId | String | Query | 是 | 无 | 企业ID,通过管理平台-云视讯API获得 | |
signature | String | Query | 签名鉴权1.0(旧):是 签名鉴权2.0:否 | 无 | API签名,参考 签名鉴权 | |
startTime | Long | Query | 是 | 无 | 开始时间 | 3.9 |
endTime | Long | Query | 是 | 无 | 结束时间 | 3.9 |
pageIndex | int | Query | 否 | 0 | 页码: 从0开始 | 3.9 |
pageSize | int | Query | 否 | 10 | 每页查询数量: 最大50 | 3.9 |
请求成功返回结果示例
{
"page": 0,
"pageTotal": 1,
"rowsTotal": 2,
"rows": 2,
"list": [
{
"vodId": 123,
"displayName": "16/07/29 11:40",
"startTime": 1470452566000,
"endTime": 1470452566000,
"fileSize":1231223432,
"meetingRoomNumber": "91200001370",
"nemoNumber": null,
"vodMetadataType":"SERVER_RECORD",
"thumbnailUrl": "xxxxxx",
"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"
},
{
"vodId": 1231,
"displayName": "16/07/29 11:40",
"startTime": 1470452566000,
"endTime": 1470452566000,
"fileSize":1231223432,
"meetingRoomNumber": "91800001370",
"nemoNumber": null,
"vodMetadataType":"SERVER_RECORD",
"thumbnailUrl": "xxxxxx",
"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"
}
]
}
返回参数说明:
参数名称 | 说明 |
vodId | 视频的ID |
displayName | 视频的默认名称,一般为时间 |
startTime | 录制的开始时间 UNIX时间毫秒 |
endTime | 录制的结束时间 UNIX时间毫秒 |
fileSize | 文件大小,单位字节 |
meetingRoomNumber | 云会议室录制的云会议号,如果是小鱼录制,则为空 |
nemoNumber | 小鱼录制的小鱼号 |
vodMetadataType | LOCAL_RECORD(本地小鱼录像机录制),SERVER_RECORD(会议录制),LIVE_RECORD(直播录制),SERVER_RECORD_TRANSCODING(会议录制转码中,此状态下不能播放、下载视频文件,24小时内处理完成后才可以播放、下载 |
thumbnailUrl | 适配缩略图下载链接 |
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错误码