文档

查询录像文件

API接口URL

https://sdk.cloudroom.com/CLOUDMEETING-API/netDisk/query

请求方式：POST

参数

接口参数

名称	类型	是否必传	说明
FileName	String	否	详细文件地址，例如文件 demo.mp4 在根目录下，则值为 /demo.mp4；在二级目录 A 下，则值为 /A/demo.mp4
FilePath	String	否	文件夹地址，要以一个/为结束，例如A目录下的录像，则值为 /A/；
SearchTime	String	否	查询时间，用于解决翻页时出现的数据不一致问题，值传返回的searchTime即可，格式如 2025-01-23 00:00:00，表示查询该时间之前的数据
PageNumber	Integer	否	分页查询页数，最小值 1 ，默认 1
PageSize	Integer	否	分页查询每页数量，最小值 1 最大值 50 ，默认 20

请求参数示例

{
    "RequestId":"95257a6e-dd78-19f9-0c78-3f3de5d35191",
    "CompID":111111,
    "SecretKey":"08635988d9be4151fcb5251b0af2b3c1",
    "FilePath": "/test/",
    "SearchTime": "2025-05-21 12:00:00",
    "PageNumber":1,
    "PageSize":20
}

请求示例

curl -X POST 'https://sdk.cloudroom.com/CLOUDMEETING-API/netDisk/query' \
-H "Content-Type: application/json" \
-d '{"RequestId":"95257a6e-dd78-19f9-0c78-3f3de5d35191","CompID":"111111","SecretKey":"08635988d9be4151fcb5251b0af2b3c1","FilePath":"/test/"}'

返回数据

名称	类型	说明
RspCode	String	响应码
RspDesc	String	响应描述
Data	map	数据集合

Data数据

名称	类型	说明
fileList	list	文件集合
dirData	list	目录集合
fileNum	Long	录像总数
searchTime	String	查询时间

fileList数据

名称	类型	说明
id	Integer	文件id
fileName	String	文件名称
filePath	String	文件路径
fileSize	String	文件大小
duration	Integer	时长（单位：秒）
downUrl	String	文件下载路径
ctime	String	文件上传时间

dirData数据

名称	类型	说明
dirId	Integer	目录id
parentId	Integer	父目录id
dirPath	String	目录路径
dirName	String	目录名称

返回参数示例

{
    "Data": {
        "searchTime": "2025-05-21 12:00:00",
        "fileNum": 1,
        "dirData": [],
        "fileList": [
            {
                "duration": 0,
                "fileName": "84653960_test.mp4",
                "downUrl": "https://sdk.cloudroom.com/docs/M00/00/21/wKgAGWgtTiOAE1c8AAt754XsrIQ4110390?name=test.mp4",
                "fileSize": "735kb",
                "filePath": "/test/test.mp4",
                "ctime": "2025-05-21 11:54:24",
                "id": 15243781
            }
        ]
    },
    "RspCode": 0,
    "RspDesc": "请求成功"
}

返回状态码RspCode说明

数值	说明
0	请求成功
1	用户所属企业没有接口API权限
2	账号不存在
3	密码错误
4	未获取到正确参数
5	未知错误