设备文件检索 - 平台接口

请求参数

Path 参数

puid

string

必需

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

必需

userID

string

用户ID

可选

fileType

array[string]

文件类型

可选

枚举值:

videoaudioimagegpslogfirmware

recordReason

array[string]

录像原因

可选

枚举值:

manualtimealarmautouploaddownloadcall

channelIndex

number

可选

通道号，-1：不作为索引条件

desc1

string

描述1 精确查找

可选

desc2

string

描述2 模糊匹配

可选

match

string

可选

模糊匹配，包括puID,userID,文件名

示例

{
    "page": 0,
    "pageSize": 20,
    "filter": {
        "beginTime": 1741104000,
        "endTime": 1741190399,
        "puID": "PU_20012295",
        "channelIndex": -1,
        "exportAll": null,
        "setSelectedMediaDatas": [],
        "setSelectedMediaDatasKeys": []
    }
}

示例代码

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/pu/recordfile/filter/' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": 0,
    "pageSize": 20,
    "filter": {
        "beginTime": 1741104000,
        "endTime": 1741190399,
        "puID": "PU_20012295",
        "channelIndex": -1,
        "exportAll": null,
        "setSelectedMediaDatas": [],
        "setSelectedMediaDatasKeys": []
    }
}'

返回响应

🟢200成功

application/json

Body

code

enum<integer>

错误码

必需

枚举值:

012357468916101112131415171819

msg

string

错误描述

必需

pageInfo

object (pageInfo)

分页结果信息

可选

page

number

分页,从零开始

必需

pageSize

number

分页大小

必需

totalCount

number

条目总数

必需

data

array [object {18}]

数据列表

可选

fileID

string

文件ID

必需

由NRU生成

serverFileId

string

平台文件ID

必需

上传到平台后平台返回的fileID

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

经度

可选

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

classID

integer

分类ID

可选

className

string

分类名称

可选

示例

{
    "code": 0,
    "msg": "OK",
    "pageInfo": {
        "page": 0,
        "pageSize": 20,
        "totalCount": 2
    },
    "data": [
        {
            "fileID": "L3N0b3JhZ2UvNTVCMC0xMEVCL01QVS9TdG9yYWdlL0xvZy9QVV8yMDAxMjI5NV8wMF8yMDI1MDMwNV8wOTQ4MDhfTEEwODAwLnR4dA",
            "fileName": "PU_20012295_00_20250305_094808_LA0800.txt",
            "channelIndex": 0,
            "filePath": "/storage/55B0-10EB/MPU/Storage/Log/PU_20012295_00_20250305_094808_LA0800.txt",
            "fileType": "log",
            "fileSize": 26714,
            "beginTime": 1741139288,
            "endTime": 1741139288,
            "insertTime": 0,
            "recordReason": "manual",
            "desc1": "",
            "desc2": "",
            "lng": 200,
            "lat": 200,
            "serverFileId": "sipe5477947b3772f93e86598648fbff9af"
        },
        {
            "fileID": "L3N0b3JhZ2UvNTVCMC0xMEVCL01QVS9TdG9yYWdlL1ZpZGVvL1BVXzIwMDEyMjk1XzAwXzIwMjUwMzA1XzA5NTUxNV9MQTA4MDAubXA0",
            "fileName": "PU_20012295_00_20250305_095515_LA0800.mp4",
            "channelIndex": 0,
            "filePath": "/storage/55B0-10EB/MPU/Storage/Video/PU_20012295_00_20250305_095515_LA0800.mp4",
            "fileType": "video",
            "fileSize": 28573744,
            "beginTime": 1741139715,
            "endTime": 1741139715,
            "insertTime": 0,
            "recordReason": "manual",
            "desc1": "",
            "desc2": "000000",
            "lng": 117.1982628,
            "lat": 31.8524184,
            "serverFileId": "sip58eecb06c2425d08b7969a1d3a6808d5"
        }
    ]
}