查询录像文件
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 | 未知错误 |