平台文件检索 - 平台接口

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

Authorization

string

必需

login成功返回的token

Body 参数application/json

过滤条件

page

number

分页

必需

从零开始

pageSize

number

分页大小

必需

filter

object

过滤条件

必需

beginTime

number

开始时间

必需

Unix时间戳，精确到秒

endTime

number

结束时间

必需

Unix时间戳，精确到秒

puid

string

设备id

可选

channelIndex

number

通道号

可选

userid

string

用户id

可选

fileType

array[string]

文件类型

可选

枚举值:

videoaudioimagegpslogfirmware

recordReason

array[string]

录像原因

可选

枚举值:

manualtimealarmautouploaddownloadcallstation

desc1

string

描述1

可选

精确查找

desc2

string

描述2

可选

模糊匹配

match

string

模糊匹配

可选

包括puID,userID,文件名

mark

boolean

重点标记

可选

是否为重点标记文件

classID

array[integer]

文件分类

可选

insertBeginTime

number

上传时间范围[

可选

Unix时间戳，精确到秒

insertEndTime

number

上传时间范围]

可选

Unix时间戳，精确到秒

userGroup

array[string]

过滤用户组

可选

deviceGroup

array[string]

过滤设备组

可选

示例

{
    "page": 0,
    "pageSize": 0,
    "filter": {
        "beginTime": 0,
        "endTime": 0,
        "puid": "string",
        "channelIndex": 0,
        "userid": "string",
        "fileType": [
            "video"
        ],
        "recordReason": [
            "manual"
        ],
        "desc1": "string",
        "desc2": "string",
        "match": "string",
        "mark": true,
        "classID": [
            0
        ],
        "insertBeginTime": 0,
        "insertEndTime": 0,
        "userGroup": [
            "string"
        ],
        "deviceGroup": [
            "string"
        ]
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://192.168.88.32:9781/bvcsp/v1/recordfile/filter' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": 0,
    "pageSize": 0,
    "filter": {
        "beginTime": 0,
        "endTime": 0,
        "puid": "string",
        "channelIndex": 0,
        "userid": "string",
        "fileType": [
            "video"
        ],
        "recordReason": [
            "manual"
        ],
        "desc1": "string",
        "desc2": "string",
        "match": "string",
        "mark": true,
        "classID": [
            0
        ],
        "insertBeginTime": 0,
        "insertEndTime": 0,
        "userGroup": [
            "string"
        ],
        "deviceGroup": [
            "string"
        ]
    }
}'

返回响应

🟢200成功

application/json

Body

code

enum<integer>

错误码

必需

枚举值:

012357468916101112131415171819

msg

string

错误描述

必需

pageInfo

object (pageInfo)

分页结果信息

可选

page

number

分页,从零开始

必需

pageSize

number

分页大小

必需

totalCount

number

条目总数

必需

data

array [object {24}]

数据列表

可选

id

integer

自增ID

可选

fileID

string

文件ID

必需

由NRU生成

nruID

string

文件所在的NRU

必需

puID

string

录像来源设备ID

必需

puName

string

设备名称

可选

userID

string

录像来源用户账号

可选

userName

string

用户名称

可选

channelIndex

integer

录像来源通道号

可选

filePath

string

存储全路径

必需

fileType

enum<string>

文件类型

必需

枚举值:

videoaudioimagegpslogfirmware

fileSize

integer

必需

文件大小(单位byte)

fileHash

string

可选

文件哈希(sha256)

beginTime

integer

录像开始时间

必需

Unix时间戳，精确到秒

endTime

integer

录像结束时间

可选

Unix时间戳，精确到秒

insertTime

integer

文件入库时间

必需

Unix时间戳，精确到秒

recordReason

enum<string>

录像原因

可选

枚举值:

manualtimealarmautouploaddownloadcallstation

desc1

string

描述1

可选

精确查找

desc2

string

描述2

可选

模糊匹配

fileName

string

文件名

可选

lat

number

纬度

可选

北纬是正值，南纬是负值,单位:度

lng

number

经度

可选

东经是正值，西经负值,单位:度

mark

boolean

重点标记

可选

是否为重点标记文件

classID

integer

分类ID

可选

className

string

分类名称

可选

示例

{
    "code": 0,
    "msg": "string",
    "pageInfo": {
        "page": 0,
        "pageSize": 0,
        "totalCount": 0
    },
    "data": [
        {
            "id": 0,
            "fileID": "string",
            "nruID": "string",
            "puID": "string",
            "puName": "string",
            "userID": "string",
            "userName": "string",
            "channelIndex": 0,
            "filePath": "string",
            "fileType": "video",
            "fileSize": 0,
            "fileHash": "string",
            "beginTime": 0,
            "endTime": 0,
            "insertTime": 0,
            "recordReason": "manual",
            "desc1": "string",
            "desc2": "string",
            "fileName": "string",
            "lat": 0,
            "lng": 0,
            "mark": true,
            "classID": 0,
            "className": "string"
        }
    ]
}