1. 人员聚类

人员聚类

1.1. 人员聚类任务添加

基础信息

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

请求方法: POST

请求参数

Headers:

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

Body:

名称 类型 必须 默认值 备注
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 任务状态描述

响应示例:

{
    "code": 0,
    "data": {
        "list": [
            {
                "createdTime": 1679020563000,
                "frequency": 10,
                "name": "聚类任务1",
                "pointBeanList": [
                    {
                        "pointName": "MegEye-W5K-I8",
                        "pointUuid": "b28a303784fd4dc7b3c73ad5794719f1"
                    }
                ],
                "statusDesc": "已完成",
                "timespan": 2,
                "uuid": "94b492b68e5c4156bd76d7aff004d1df"
            }
        ],
        "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)

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 区域名
      |─fullImageUrl 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": "成功"
}

results matching ""

    No results matching ""