基于上位机软件webserver的二次开发
关注公众号
原创
底库管理-人脸底库

1. 添加人脸库

  • 接口功能描述：添加人脸姓名、性别等至底库，添加前判断限制最多1000个人脸；
  • 接口路径：[POST] http://云服务IP:9191/ks/proxy/face；
  • 接口说明：如需上传人脸图片，请参照9.2.10.6修改人脸图像接口。
  • 请求参数说明；
参数名称数据类型是否必须说明
device_idsArray是设备ID数组
group_idString是分组ID
external_idString否外部id
nameString是姓名
sexString否性别
ageString否年龄
descString否简介

表. 请求参数

参数名称数据类型是否必须说明
AuthorizationString是‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

  • 请求示例；
项目详情
请求格式JSON
报文内容{
    "device_ids": ["c92254f2-6124-4f9d-b3e2-feb0f33c1df8"],
    "group_id": "6593e3aa522e4b9ab8454f54",
    "external_id": "98",
    "name": "小明",
    "sex": "男",
    "age": "10"
}
  • 响应参数说明；
参数名称数据类型说明
error_codeInt返回响应码
0: 成功
-1: 客户端错误
-2: 服务端错误
messageString返回响应信息
dataObject以对象形式返回每个设备是否成功
  • 响应示例。
项目详情
报文格式JSON
报文内容{
    "data": {
        "20e0c32b-f937-4cf2-9e8c-96d1e60e6519": {
            "id": "6593e3aa522e4b9ab8454f54",
            "result": true,
            "reason": null
        }
    },
    "error_code": 0,
    "message": {
        "zh": "新增人脸成功！",
        "en": "Add face successful!"
    }
}

2. 修改人脸库

参数名称数据类型是否必须说明
device_idsArray是设备ID数组
idString否人脸id
group_idString否若同时存在group_id和external_id则忽略id
external_idString否
nameString否姓名
sexString否性别
ageString否年龄
descString否简介

表. 请求参数

参数名称数据类型是否必须说明
AuthorizationString是‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

  • 请求示例；
项目详情
请求格式JSON
报文内容
   		{
    "device_ids": ["c92254f2-6124-4f9d-b3e2-feb0f33c1df8"],
    "group_id": "6593e3aa522e4b9ab8454f54",
    "external_id": "98"
}
  • 响应参数说明；
参数名称数据类型说明
error_codeInt返回响应码
0: 成功
-1: 客户端错误
-2: 服务端错误
messageString返回响应信息
dataObject以对象形式返回每个设备是否成功
  • 响应示例。
项目详情
报文格式JSON
报文内容{
    "data": {
        "20e0c32b-f937-4cf2-9e8c-96d1e60e6519": {
            "result": true,
            "reason": null
        }
    },
    "error_code": 0,
    "message": {
        "zh": "更新人脸成功！",
        "en": "Update face successful!"
    }
}

3. 查询人脸库

参数名称数据类型是否必须说明
pageInt是页码
sizeInt是每页数量
device_idString是设备ID
group_idString否分组ID
external_idString否外部id
nameString否姓名
start_timeInt否开始时间秒数
end_timeInt否结束时间秒数

表. 请求参数

参数名称数据类型是否必须说明
AuthorizationString是‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

  • 请求示例；
项目详情
请求格式Query String
page1
size10
device_idc92254f2-6124-4f9d-b3e2-feb0f33c1df8
group_id6593e3aa522e4b9ab8454f54
name"张三"
start_time1704211200
end_time1704384000
  • 响应参数说明；
参数名称数据类型说明
error_codeInt返回响应码
0: 成功
-1: 客户端错误
-2: 服务端错误
messageString返回响应信息
dataObjectnull
  • 响应示例。
项目详情
报文格式JSON
报文内容{
    "error_code": 0,
    "message": {
        "zh": "查询人脸成功！",
        "en": "Query face successful!"
    },
    "data": {
        "age": 1,
        "external_id": "98",
        "desc": "1234",
        "device_id": "df0fef91-a835-4197-bf59-c6ea18a492af",
        "id": "6593e3aa522e4b9ab8454f54",
        "image": "/9j/4AAQSkZJRg…",
        "name": "123",
        "sex": "男",
        "update_time": 1704351807
    }
}

4. 删除人脸库

参数名称数据类型是否必须说明
device_idsArray是设备ID数组
idsArray否人脸id数组
group_idString否若存在group_id，或者同时存在group_id和external_ids，则忽略ids
external_idsArray否

表. 请求参数

参数名称数据类型是否必须说明
AuthorizationString是‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

  • 请求示例；
项目详情
请求格式JSON
报文内容{
    "device_ids": ["c92254f2-6124-4f9d-b3e2-feb0f33c1df8"],
    "ids": ["6593e3aa522e4b9ab8454f54"]
}
  • 响应参数说明；
参数名称数据类型说明
error_codeInt返回响应码
0: 成功
-1: 客户端错误
-2: 服务端错误
messageString返回响应信息
dataObject以对象形式返回每个设备是否成功
  • 响应示例。
项目详情
报文格式JSON
报文内容{
    "data": {
        "20e0c32b-f937-4cf2-9e8c-96d1e60e6519": {
            "result": true,
            "reason": null
        }
    },
    "error_code": 0,
    "message": "删除人脸成功！"
}

5. 载入底库

  • 接口功能描述：增加、修改、删除后需要调用一次使其生效，为避免影响检测，此接口不能频繁调用，最好是一批操作结束后通知用户手动调用；
  • 接口路径：[POST] http://云服务IP:9191/ks/proxy/face/load；
  • 请求参数说明；
参数名称数据类型是否必须说明
device_idsArray是设备ID数组

表. 请求参数

参数名称数据类型是否必须说明
AuthorizationString是‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

  • 请求示例；
项目详情
请求格式JSON
报文内容{
"device_ids": ["c92254f2-6124-4f9d-b3e2-feb0f33c1df8"]
}
  • 响应参数说明；
参数名称数据类型说明
error_codeInt返回响应码
0: 成功
-1: 客户端错误
-2: 服务端错误
messageString返回响应信息
dataObject以对象形式返回每个设备是否成功
  • 响应示例。
项目详情
报文格式JSON
报文内容{
    "data": {
        "20e0c32b-f937-4cf2-9e8c-96d1e60e6519": {
            "result": true,
            "reason": null
        }
    },
    "error_code": 0,
    "message": {
        "zh": "载入成功！",
        "en": "Successful loaded!"
    }
}

6. 添加或修改人脸图像

参数名称数据类型是否必须说明
device_idsString是设备ID数组
idString否人脸id
group_idString否若同时存在group_id和external_id则忽略id
external_idString否
imageFile是人脸图片

表. 请求参数

参数名称数据类型是否必须说明
AuthorizationString是‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

  • 请求示例；
项目详情
请求格式Form Data
device_ids["c92254f2-6124-4f9d-b3e2-feb0f33c1df8"]
id6593e3aa522e4b9ab8464f56
image(binary)
  • 响应参数说明；
参数名称数据类型说明
error_codeInt返回响应码
0: 成功
-1: 客户端错误
-2: 服务端错误
messageString返回响应信息
dataObject以对象形式返回每个设备是否成功
  • 响应示例。
项目详情
报文格式JSON
报文内容{
    "data": {
        "20e0c32b-f937-4cf2-9e8c-96d1e60e6519": {
            "result": true,
            "reason": null
        }
    },
    "error_code": 0,
    "message": {
        "zh": "更新人脸成功！",
        "en": "Update face successful!"
    }
}

7. 下载模板

参数名称数据类型是否必须说明
group_idString是分组ID
templateBool是true

表. 请求参数

参数名称数据类型是否必须说明
AuthorizationString是‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

注意：前端调用时，还需指定responseType:'blob'。

  • 请求示例；
项目详情
请求格式Query String
group_id6593e3aa522e4b9ab8454f54
templatetrue
  • 响应参数说明；
参数名称数据类型说明
dataString文件流
  • 响应示例。
项目详情
报文格式文件流
报文内容略

8. 批量导入

参数名称数据类型是否必须说明
device_idString是设备ID数组
group_idString是分组ID
packageFile是文件

表. 请求参数

参数名称数据类型是否必须说明
AuthorizationString是‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

  • 请求示例；
项目详情
请求格式Form Data
device_idc92254f2-6124-4f9d-b3e2-feb0f33c1df8
group_id6593e3aa522e4b9ab8454f54
package(binary)
  • 响应参数说明；
参数名称数据类型说明
error_codeInt返回响应码
0: 成功
-1: 客户端错误
-2: 服务端错误
messageString返回响应信息
dataObject 
  • 响应示例。
项目详情
报文格式JSON
报文内容{
    "data": null,
    "error_code": 0,
    "message": {
        "zh": "导入人脸底库成功！",
        "en": "Import face library successful!"
    }
}

9. 批量导出

参数名称数据类型是否必须说明
group_idString是分组ID

表. 请求参数

参数名称数据类型是否必须说明
AuthorizationString是‘Bearer ’+ token; token通过获取token接口获取

表. 请求头

注意：前端调用时，还需指定responseType:'blob'。

  • 请求示例；
项目详情
请求格式Query String
group_id6593e3aa522e4b9ab8454f54
  • 响应参数说明；
参数名称数据类型说明
dataString文件流
  • 响应示例。
项目详情
报文格式文件流
报文内容略

真诚点赞 诚不我欺

底库管理-人脸底库