音视频通话

查询录像文件

API接口URL

https://sdk.cloudroom.com/CLOUDMEETING-API/v2/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

请求示例

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

返回数据

字段名 类型 说明
RspCode String 响应码
RspDesc String 响应描述
Data Object 数据主体(详见下表)

Data 对象结构

字段名 类型 说明
searchTime String 查询时间
fileNum Long 当前目录下录像文件总数
dirData DirData[] 目录列表
fileList FileList[] 文件列表

DirData 对象结构

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

FileList 对象结构

字段名 类型 说明
id Integer 文件 id
fileName String 文件名
filePath String 文件路径
fileSize Long 文件大小,单位:B(字节)
duration Integer 时长,单位:秒
downUrl String 文件下载地址
ctime String 文件上传时间

返回参数示例

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

返回状态码RspCode说明

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