1. 人员聚类

人员聚类

1.1. 人员聚类任务添加

基础信息

路径: /v1/api/cluster/task/add

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
deviceUuid string 否 算力设备uuid，为空用中心Core
taskName string 是 聚类规则名称，长度1-40位
pointUuidList array 是 点位uuid列表
  |─ string
timespan integer 是 选择时间，范围0~90天
frequency integer 是 出现次数，范围2~100次

Body示例:

{
    "taskName": "聚类任务1", 
    "pointUuidList": [
        "63311c70c107413eaab73dd91f63e50b",
        "f2b5ac9f94bc4106a46cfa97bde44308"
    ], 
    "timespan": 2, 
    "frequency": 10
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 备注
code integer 返回值code
msg string 返回值消息
data object 具体的返回值
  |─taskUuid string 任务uuid
  |─failMsg string 失败点位信息

响应示例:

{
    "code": 0,
    "data": {
        "taskUuid": "94b492b68e5c4156bd76d7aff004d1df"
    },
    "msg": "成功"
}

1.2. 人员聚类任务状态查询

基础信息

路径: /v1/api/cluster/task/status

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
taskUuid string 是 任务uuid

Body示例:

{
  "taskUuid": "94b492b68e5c4156bd76d7aff004d1df"
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 备注
code integer 返回值code
msg string 返回值消息
data object 具体的返回值
  |─statusType integer 任务状态类型, 0-处理中;1-已完成
  |─statusDesc string 任务状态描述

响应示例:

{
  "code": 0,
  "msg": "",
  "data": {
    "statusType": 1,
    "statusDesc": "已完成"
  }
}

1.3. 人员聚类任务删除

基础信息

路径: /v1/api/cluster/task/delete

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
taskUuid string 是 任务uuid

Body示例:

{
  "taskUuid": "94b492b68e5c4156bd76d7aff004d1df"
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 备注
code integer 返回值code
msg string 返回值消息
data object 具体的返回值

响应示例:

{
    "code": 0,
    "msg": "成功"
}

1.4. 人员聚类任务列表查看

基础信息

路径: /v1/api/cluster/task/list

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
name string 否 任务名称，做模糊匹配
pageNum integer 否 1 当前页, 默认值1
pageSize integer 否 10 每页条数, 默认值10

Body示例:

{
    "name": "聚类",
    "pageNum": 1,
    "pageSize": 10
}

返回数据

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
      |─uuid string 任务uuid
      |─name string 任务名称
      |─frequency integer 出现次数
      |─pointBeanList array 点位信息
        |─ object
          |─pointUuid string 点位uuid
          |─pointName string 点位名称
      |─timespan integer 时间范围，1-90表示近多少天
      |─createdTime integer 任务创建时间
      |─status integer 任务状态类型, 0-处理中;1-已完成
      |─statusDesc string 任务状态描述
      |─deviceUuid string 聚类算力设备uuid
      |─deviceName string 设备名称

响应示例:

{
    "code": 0,
    "data": {
        "list": [
            {
                "createdTime": 1679020563000,
                "frequency": 10,
                "name": "聚类任务1",
                "pointBeanList": [
                    {
                        "pointName": "MegEye-W5K-I8",
                        "pointUuid": "b28a303784fd4dc7b3c73ad5794719f1"
                    }
                ],
                "statusDesc": "已完成",
                "timespan": 2,
                "uuid": "94b492b68e5c4156bd76d7aff004d1df",
                "deviceUuid": "DE-a1d5383a19b94d2db29b556565a1dcbc",
                "deviceName": "边缘幻方111"
            }
        ],
        "pageNum": 1,
        "pageSize": 10,
        "total": 1
    },
    "msg": "成功"
}

1.5. 人员聚类任务详情查看

基础信息

路径: /v1/api/cluster/task/detail/query

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
taskUuid string 是 任务uuid
pageNum integer 否 1 当前页, 默认值1
pageSize integer 否 10 每页条数, 默认值10
filed string 否 latestTime 排序字段：按抓拍次数，使用frequency，按最新抓拍时间就是用latestTime，不传默认按照最新抓拍时间倒序

Body示例:

{
    "taskUuid": "94b492b68e5c4156bd76d7aff004d1df",
    "filed":"frequency",
    "pageNum": 1,
    "pageSize": 10
}

返回数据

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
      |─profileId string 档案id
      |─url string 抓拍图
      |─frequency integer 出现次数
      |─latestTime integer 最近出现时间，时间戳，单位ms

响应示例:

{
    "code": 0,
    "data": {
        "list": [
            {
                "frequency": 12,
                "latestTime": 1678872911422,
                "profileId": "4649882d-0adf-40c9-8e22-a47a05c50245",
                "url": "http://10.171.5.193:80/v1/storage/download/Z3NwOi8vd3Vrb25nLW1lZ2xpbms=-eed412f788e7e11b3b0608cade8172aa"
            }
        ],
        "pageNum": 1,
        "pageSize": 10,
        "total": 1
    },
    "msg": "成功"
}

1.6. 人员聚类人员详情查看

基础信息

路径: /v1/api/cluster/person/detail/query

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
taskUuid string 是 任务uuid
profileId string 是 人员档案id
pageNum integer 否 1 当前页, 默认值1
pageSize integer 否 10 每页条数, 默认值10
pointUuidList array 否 分析源点位uuid集合
  |─ string
startTime integer 否 起始时间-时间戳(ms)
endTime integer 否 结束时间-时间戳(ms)
deviceUuid String 否 设备uuid

Body示例:

{
    "profileId": "4649882d-0adf-40c9-8e22-a47a05c50245",
    "taskUuid": "94b492b68e5c4156bd76d7aff004d1df",
    "pageSize": 2,
    "pageNum": 1,
    "endTime": 1677599999000,
    "startTime": 1675008000000,
    "pointUuidList": [
      "b28a303784fd4dc7b3c73ad5794719f1",
      "d909d84343a64dc5936c458edaf3e8cf"
    ]
}

返回数据

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
      |─profileId string 人员档案id
      |─url string 抓拍图
      |─pointUuid string 点位uuid
      |─pointName string 点位名称
      |─timestamp integer 出现时间
      |─zoneName string 区域名

响应示例:

{
    "code": 0,
    "data": {
        "list": [
            {
                "pointName": "MegEye-W5K-I8",
                "pointUuid": "b28a303784fd4dc7b3c73ad5794719f1",
                "profileId": "4649882d-0adf-40c9-8e22-a47a05c50245",
                "timestamp": 1678872911422,
                "url": "http://10.171.5.193:80/v1/storage/download/Z3NwOi8vd3Vrb25nLW1lZ2xpbms=-48bd8fc9cb63df0bd294245cf063c412",
                "zoneName": "LX"
            },
            {
                "pointName": "MegEye-W5K-I8",
                "pointUuid": "b28a303784fd4dc7b3c73ad5794719f1",
                "profileId": "4649882d-0adf-40c9-8e22-a47a05c50245",
                "timestamp": 1678872855116,
                "url": "http://10.171.5.193:80/v1/storage/download/Z3NwOi8vd3Vrb25nLW1lZ2xpbms=-6a8d529f731d34dd478652c7910b869e",
                "zoneName": "LX"
            }
        ],
        "pageNum": 1,
        "pageSize": 2,
        "total": 12
    },
    "msg": "成功"
}

1.7. 高频未知人员列表查看

基础信息

路径: /v1/api/cluster/stranger/list/query

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
frequency integer 否 出现次数
pageNum integer 否 1 当前页，默认第一页
pageSize integer 否 10 每页条数，默认10条，每次查询最大不超过100条
filed string 否 排序字段：按抓拍次数，使用frequency，按最新抓拍时间就是用latestTime，不传默认按照最新抓拍时间倒序
deviceUuid string 否 算力设备uuid，core不传，非core需要传

Body示例:

{
    "filed":"latestTime",
    "pageNum": 1,
    "pageSize": 2
}

返回数据

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
      |─profileId string 否 档案id
      |─url string 否 封面图
      |─frequency integer 否 出现次数
      |─latestTime integer 否 最近出现时间

响应示例:

{
    "code": 0,
    "data": {
        "list": [
            {
                "frequency": 28,
                "latestTime": 1685958966093,
                "profileId": "0ac57421-e578-4b75-8530-ea374a9738c1",
                "url": "http://169.42.42.42:28089/v1/storage/download/Z3NwOi8vbWVnY29ubmVjdC1mYWNlLWNhcA==-183c6ba4704e4c04b23d.jpg"
            },
            {
                "frequency": 85,
                "latestTime": 1685958964699,
                "profileId": "99d0bebd-7f3b-48b0-8bb8-080152447fbc",
                "url": "http://169.42.42.42:28089/v1/storage/download/Z3NwOi8vbWVnY29ubmVjdC1mYWNlLWNhcA==-67970a3119204b97bb3b.jpg"
            }
        ],
        "pageNum": 1,
        "pageSize": 2,
        "total": 3373
    },
    "msg": "成功"
}

1.8. 高频未知人员详情查看

基础信息

路径: /v1/api/cluster/stranger/detail/query

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
profileId string 是 人员档案id
deviceUuid string 否 算力设备uuid，core不传，非core需要传
pointUuidList array 否 分析源点位uuid集合
  |─ string
startTime integer 是 开始时间
endTime integer 是 结束时间
pageNum integer 否 1 当前页，默认第一页
pageSize integer 否 10 每页条数，默认10条，每次查询最大不超过100条

Body示例:

{
    "profileId":"0ac57421-e578-4b75-8530-ea374a9738c1",
    "pageNum": 1,
    "pageSize": 2
}

返回数据

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
      |─profileId string 否 人员档案id
      |─url string 否 抓拍图
      |─pointUuid string 否 点位uuid
      |─pointName string 否 点位名称
      |─timestamp integer 否 出现时间
      |─zoneName string 否 区域名
      |─recognitionType integer 否 5 人员类型：5.未知人员

响应示例:

{
    "code": 0,
    "data": {
        "list": [
            {
                "pointName": "算力引擎1-通道4",
                "pointUuid": "554e8f15a11141a1ae3da4bfe273a466",
                "profileId": "0ac57421-e578-4b75-8530-ea374a9738c1",
                "recognitionType": 5,
                "timestamp": 1685958966093,
                "url": "http://169.42.42.42:28089/v1/storage/download/Z3NwOi8vbWVnY29ubmVjdC1mYWNlLWNhcA==-bd2d62dce71743848f38.jpg",
                "zoneName": "默认区域"
            },
            {
                "pointName": "算力引擎1-通道1",
                "pointUuid": "e3aa6ebf97e045308bd77b6474e9770f",
                "profileId": "0ac57421-e578-4b75-8530-ea374a9738c1",
                "recognitionType": 5,
                "timestamp": 1685958930348,
                "url": "http://169.42.42.42:28089/v1/storage/download/Z3NwOi8vbWVnY29ubmVjdC1mYWNlLWNhcA==-514eca4cab50429da32f.jpg",
                "zoneName": "默认区域"
            }
        ],
        "pageNum": 1,
        "pageSize": 2,
        "total": 28
    },
    "msg": "成功"
}

results matching ""

    No results matching ""