1. 人员识别记录
人员识别记录
1.1. 安防人员记录列表
基础信息
路径: /v1/api/person/record/list
请求方法: POST
备注: 安防记录分页查询接口,支持根据人员类型、实名人员姓名、分析源、时间段条件查询
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | application/json | 是 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
personTag | integer | 否 | 人员类型 1.基础人员 2.访客 3.关注人员 4.未授权人员 5.未知人员 | |
recognitionType | array | 否 | 身份选择 1.基础人员 2.访客 3.关注人员 4.未授权人员 5.未知人员(与personTag含义相同,两者都存在是此值优先级高) | |
|─ | integer | |||
personName | string | 否 | 非必须 人员姓名 限制长度40位 | |
pointUuids | array | 否 | 监控点ID集合-分析源 | |
|─ | string | |||
startTime | integer | 是 | 必须 开始时间/毫秒 | |
endTime | integer | 是 | 必须 结束时间/毫秒 | |
pageNum | integer | 否 | 1 | 页码,从1开始 当前页码,不传默认1 |
pageSize | integer | 否 | 20 | 页面大小 分页大小,不传默认20 |
Body示例:
{
"pageNum": 1,
"pageSize": 2,
"startTime": 1678341167591,
"endTime": 1678341267591
}
返回数据
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
content-type | application/json;charset=UTF-8 | 否 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
code | integer | 否 | 返回值code | |
msg | string | 否 | 返回值消息 | |
data | object | 否 | 具体的返回值 | |
|─pageNum | integer | 是 | 页码,从1开始 当前页码 |
|
|─pageSize | integer | 是 | 页面大小 分页大小 |
|
|─total | integer | 是 | 总记录数 总数 |
|
|─list | array | 否 | ||
|─ | object | |||
|─idUuid | string | 否 | 记录主键uuid | |
|─captureImageUrl | string | 否 | 抓拍图URL | |
|─groupImageUrl | string | 否 | 底库图URL | |
|─personTagArray | array | 否 | 人员标签 | |
|─ | string | |||
|─personName | string | 否 | 人员名称 | |
|─personCode | string | 否 | 人员CODE | |
|─personUuid | string | 否 | 人员UUID | |
|─orgUuid | string | 否 | 组织UUID | |
|─orgFullName | string | 否 | 组织名称 | |
|─pointUuid | string | 否 | 点位UUID | |
|─pointName | string | 否 | 点位名称 | |
|─pointZoneUuid | string | 否 | 点位区域UUID | |
|─pointZoneName | string | 否 | 点位区域名称 | |
|─pointLocation | string | 否 | 点位位置 | |
|─deviceUuid | string | 否 | 设备UUID | |
|─deviceName | string | 否 | 设备名称 | |
|─channelNo | integer | 否 | 通道号 | |
|─channelUuid | string | 否 | 通道号UUID | |
|─channelName | string | 否 | 通道名称 | |
|─recognitionType | integer | 否 | 业务 PersonTypeEnum定义 身份选择 1.基础人员 2.访客 3.关注人员 4.未授权人员 5.未知人员 |
|
|─livenessType | integer | 否 | TernaryType 定义 活体类型 1.活体未知 2.非活体 3.活体 |
|
|─livenessScore | number | 否 | 活体分数 | |
|─score | number | 否 | 识别分数 | |
|─captureTime | integer | 否 | 抓拍时间 |
响应示例:
{
"code": 0,
"data": {
"list": [
{
"captureImageUrl": "http://127.0.0.1:8080/v1/storage/download/Z3NwOi8vbWVnY29ubmVjdC1mYWNlLWNhcA==-e476bd682e294345abd2.jpg",
"captureTime": 1678341267000,
"channelName": "B4H-LX_2",
"channelNo": 2,
"channelUuid": "CH-da576b20a9b54582a5c8",
"deviceName": "B4H-LX",
"deviceUuid": "DE-92e72949642445d9a0f046e0bdfd2c96",
"idUuid": "0d5a6a04-909a-4efe-ad53-535b7c2b21c0",
"livenessScore": 0,
"livenessType": 3,
"orgFullName": "###",
"orgUuid": "###",
"personCode": "",
"personName": "",
"personTagArray": [],
"personUuid": "",
"pointLocation": "",
"pointName": "B4H-LX-通道2",
"pointUuid": "6e9b4f17735b419399c7c75dbaf67f89",
"pointZoneName": "LX",
"pointZoneUuid": "e01968dbe8b54cd3938d542e6369a6c5",
"recognitionType": 5,
"score": 0
},
{
"captureImageUrl": "http://127.0.0.1:8080/v1/storage/download/Z3NwOi8vbWVnY29ubmVjdC1mYWNlLWNhcA==-4914b3cf34b0473780c9.jpg",
"captureTime": 1678341267000,
"channelName": "B4H-LX_1",
"channelNo": 1,
"channelUuid": "CH-95d61f910ad7465ab4a9",
"deviceName": "B4H-LX",
"deviceUuid": "DE-92e72949642445d9a0f046e0bdfd2c96",
"idUuid": "a5c59385-087c-4de9-937f-7346d3f4fec0",
"livenessScore": 0,
"livenessType": 3,
"orgFullName": "###",
"orgUuid": "###",
"personCode": "",
"personName": "",
"personTagArray": [],
"personUuid": "",
"pointLocation": "",
"pointName": "B4H-LX-通道1",
"pointUuid": "d4c61e3104ac488dae0109770cf899fa",
"pointZoneName": "LX",
"pointZoneUuid": "e01968dbe8b54cd3938d542e6369a6c5",
"recognitionType": 4,
"score": 0
}
],
"pageNum": 1,
"pageSize": 2,
"total": 99
},
"msg": "成功"
}
1.2. 安防人员记录详情
基础信息
路径: /v1/api/person/record/detail
请求方法: POST
备注: 安防人员记录详情接口,展示此记录的全部字段信息
请求参数
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
Content-Type | application/json | 是 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
uuid | string | 是 | 记录uuid |
Body示例:
{
"uuid": "a5c59385-087c-4de9-937f-7346d3f4fec0"
}
返回数据
Headers:
名称 | 值 | 必须 | 备注 |
---|---|---|---|
content-type | application/json;charset=UTF-8 | 否 |
Body:
名称 | 类型 | 必须 | 默认值 | 备注 |
---|---|---|---|---|
code | integer | 否 | 返回值code | |
msg | string | 否 | 返回值消息 | |
data | object | 否 | 具体的返回值 | |
|─uuid | string | 否 | 记录主键uuid | |
|─snapshotUri | string | 否 | 抓拍图URI | |
|─pointUuid | string | 否 | 点位UUID | |
|─pointName | string | 否 | 点位名称 | |
|─captureImageUrl | string | 否 | 抓拍图URL | |
|─groupImageUrl | string | 否 | 底库图URI | |
|─personImageUrl | string | 否 | 底库图URL | |
|─fullImageUrl | string | 否 | 全景图URI | |
|─frameImageUrl | string | 否 | 全景图URL | |
|─personTagArray | array | 否 | 人员标签 | |
|─ | string | |||
|─personName | string | 否 | 人员名称 | |
|─personCode | string | 否 | 人员CODE | |
|─personUuid | string | 否 | 人员UUID | |
|─visitType | integer | 否 | 访客类型 | |
|─visitPeronUuid | string | 否 | 访客UUID | |
|─visitPersonName | string | 否 | 访客姓名 | |
|─visitPersonCode | string | 否 | 访客人员CODE | |
|─orgUuid | string | 否 | 组织UUID | |
|─orgFullName | string | 否 | 组织名称 | |
|─pointZoneUuid | string | 否 | 点位区域UUID | |
|─pointZoneName | string | 否 | 点位区域名称 | |
|─pointLocation | string | 否 | 点位位置 | |
|─deviceUuid | string | 否 | 设备UUID | |
|─deviceName | string | 否 | 设备名称 | |
|─channelNo | integer | 否 | 通道号 | |
|─channelUuid | string | 否 | 通道号UUID | |
|─channelName | string | 否 | 通道名称 | |
|─personIdentifyNum | string | 否 | 身份证号 | |
|─personEmail | string | 否 | 邮箱 | |
|─personExt | string | 否 | 人员备注 | |
|─uniqueIdentify | string | 否 | 唯一标志 | |
|─personPhone | string | 否 | 手机号 | |
|─recognitionType | integer | 否 | 业务 PersonTypeEnum定义 识别类型 1.基础人员 2.访客 3.关注人员 4.未授权人员 5.未知人员 |
|
|─livenessType | integer | 否 | TernaryType 定义 活体类型 1.活体未知 2.非活体 3.活体 |
|
|─score | number | 否 | 活体分数 | |
|─recognitionScore | number | 否 | 识别分数 | |
|─captureTime | integer | 否 | 抓拍时间 | |
|─age | integer | 否 | 年龄 | |
|─genderType | integer | 否 | 性别类型-数字类型 | |
|─genderTypeDesc | string | 否 | 性别描述-字符串描述 | |
|─wearRespiratorType | integer | 否 | 是否带口罩 | |
|─wearRespiratorDesc | string | 否 | 是否带口罩-字符串描述 | |
|─personGroupArray | array | 否 | 人员组信息 | |
|─ | string | |||
|─isVideoPlayback | boolean | 否 | false | 是否支持录像回放 |
|─storageChannelUuid | string | 否 | 记录录像回放-存储设备的通道UUID |
响应示例:
{
"code": 0,
"data": {
"age": 42,
"captureImageUrl": "http://127.0.0.1:8080/v1/storage/download/Z3NwOi8vbWVnY29ubmVjdC1mYWNlLWNhcA==-b961f9b5b192489a9b3c.jpg",
"channelName": "算力引擎1_5",
"channelNo": 5,
"channelUuid": "CH-42968f41572047f09745",
"deviceName": "算力引擎1",
"deviceUuid": "DE-68660e60d9094b4f9e3b1ede67c443df",
"frameImageUrl": "http://127.0.0.1:8080/v1/storage/download/Z3NwOi8vbWVnY29ubmVjdC1mYWNlLWZ1bGw=-4a94a440aafd4fa2919a.jpg",
"genderType": 2,
"genderTypeDesc": "女性",
"groupImageUrl": "http://127.0.0.1:8080/v1/storage/download/Z3NwOi8vd3Vrb25n-f4700fa90a8971649197588367ce24ba.jpg",
"livenessType": 3,
"orgFullName": "###",
"orgUuid": "###",
"personCode": "111",
"personEmail": "",
"personExt": "",
"personGroupArray": [
"1111"
],
"personIdentifyNum": "",
"personImageUrl": "http://127.0.0.1:8080/v1/storage/download/Z3NwOi8vd3Vrb25n-f4700fa90a8971649197588367ce24ba.jpg",
"personName": "CWH",
"personPhone": "",
"personTagArray": [],
"personUuid": "3da0f4f4defb488184abfd80fadc4279",
"pointLocation": "",
"pointName": "算力引擎1-通道5",
"pointUuid": "d9faf7f7002445f68d5ca7988ce3a801",
"pointZoneName": "默认区域",
"pointZoneUuid": "0",
"recognitionScore": 78,
"recognitionType": 3,
"score": 78,
"snapshotUri": "Z3NwOi8vbWVnY29ubmVjdC1mYWNlLWNhcA==-b961f9b5b192489a9b3c.jpg",
"storageChannelUuid": "",
"uniqueIdentify": "",
"uuid": "35a02d5b-5f22-4ee8-b09a-56a24f650395",
"videoPlayback": false,
"visitPeronUuid": "",
"visitPersonCode": "",
"visitPersonName": "",
"visitType": 1,
"wearRespiratorDesc": "未佩戴",
"wearRespiratorType": 2
},
"msg": "成功"
}