人脸库管理接口
人脸库创建接口
接口描述
在添加人脸之前首先要创建人脸库，该接口提供创建人脸库的功能。
权限说明
请求发起人需要填写从token接口获取到的有效的token才能发起请求。
请求结构
HTTP方法：POST
请求URL： https://robot.baidu.com/abc-robot/openapi/v1/face-manage/group/create
Header如下：
| 头域 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| Authorization | String | 填写根据token接口获取到的token | 必须 |
请求参数
Body中放置请求参数，参数详情如下：
| 名称 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| groupId | String | 人脸库ID，项目级别唯一，提交后不可修改。数字、字母、下划线组成，长度不超过32个字符 | 必须 |
| groupName | String | 长度不超过40个字符，可修改，项目级别唯一。 | 必须 |
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| error_code | int | 错误码 |
| error_msg | String | 操作结果提示信息 |
| result | Object | 操作结果展示Model |
result的数据类型如下：
| 参数名称 | 类型 | 描述 |
|---|---|---|
| groupId | String | 人脸库ID |
| groupName | String | 人脸库Name |
| createTime | long | 创建时间 |
| updateTime | long | 更新时间 |
请求示例
1POST HTTP/1.1
2 Host: robot.baidu.com
3 Content-Type: application/json;charset=UTF-8
4 Authorization: authorization string
5 {
6 "groupId":"face_group_id_1",
7 "groupName":"face_group_name_1"
8 }响应示例
1 HTTP/1.1 200 OK
2 Content-Type: application/json;charset=UTF-8
3 {
4 "error_code":0,
5 "error_msg":"操作成功",
6 "result": {
7 "groupId":"face_group_id_1",
8 "groupName":"face_group_name_1",
9 "createTime":1547119839635,
10 "updateTime":1547119839635
11 }
12 }人脸库修改接口
接口描述
修改指定人脸库ID的人脸库信息，目前只能修改人脸库名称。
权限说明
请求发起人需要具有合法的根据token接口获取到的token才能发起请求。
请求结构
HTTP方法：POST
请求URL： https://robot.baidu.com/abc-robot/openapi/v1/face-manage/group/update
Header如下：
| 头域 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| Authorization | String | 填写根据token接口获取到的token | 必须 |
请求参数
Body中放置请求参数，参数详情如下：
| 名称 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| groupId | String | 人脸库ID | 必须 |
| groupName | String | 长度不超过40个字符，可修改，项目级别唯一。 | 必须 |
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| error_code | int | 错误码 |
| error_msg | String | 操作结果提示信息 |
请求示例
1POST HTTP/1.1
2 Host: robot.baidu.com
3 Content-Type: application/json;charset=UTF-8
4 Authorization: authorization string
5 {
6 "groupId":"face_group_id_1",
7 "groupName":"face_group_name_1_update"
8 }响应示例
1HTTP/1.1 200 OK
2 Content-Type: application/json;charset=UTF-8
3 {
4 "error_code":0,
5 "error_msg":"操作成功"
6 }人脸库详情接口
接口描述
查询指定的人脸库详情信息。
权限说明
请求发起人需要具有合法的根据token接口获取到的token才能发起请求。
请求结构
HTTP方法：POST
请求URL： https://robot.baidu.com/abc-robot/openapi/v1/face-manage/group/detail
Header如下：
| 头域 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| Authorization | String | 填写根据token接口获取到的token | 必须 |
请求参数
Body中放置请求参数，参数详情如下：
| 名称 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| groupId | String | 人脸库ID | 必须 |
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| error_code | int | 错误码 |
| error_msg | String | 错误提示信息 |
| result | Object | 操作结果展示Model |
result的数据类型如下：
| 参数名称 | 类型 | 描述 |
|---|---|---|
| groupId | String | 人脸库ID |
| groupName | String | 人脸库Name |
| createTime | long | 创建时间 |
| updateTime | long | 更新时间 |
请求示例
1POST HTTP/1.1
2 Host: robot.baidu.com
3 Content-Type: application/json;charset=UTF-8
4 Authorization: authorization string
5 {
6 "groupId":"face_group_id_1"
7 }响应示例
1HTTP/1.1 200 OK
2 Content-Type: application/json;charset=UTF-8
3 {
4 "error_code":0,
5 "error_msg":"操作成功",
6 "result": {
7 "groupId":"face_group_id_1",
8 "groupName":"face_group_name_1_update",
9 "createTime":1547119839635,
10 "updateTime":1547119839635
11 }
12 }人脸库删除接口
接口描述
删除一个指定的人脸库和该人脸库下所有的人脸，如果一个人脸在多个人脸库中存在，该操作不会删除其他人脸库中的人脸。
权限说明
请求发起人需要具有合法的根据token接口获取到的token才能发起请求。
请求结构
HTTP方法：POST
请求URL： https://robot.baidu.com/abc-robot/openapi/v1/face-manage/group/delete
Header如下：
| 头域 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| Authorization | String | 填写根据token接口获取到的token | 必须 |
请求参数
Body中放置请求参数，参数详情如下：
| 名称 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| groupId | String | 人脸库ID | 必须 |
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| error_code | int | 错误码 |
| error_msg | String | 错误提示信息 |
请求示例
1POST HTTP/1.1
2 Host: robot.baidu.com
3 Content-Type: application/json;charset=UTF-8
4 Authorization: authorization string
5 {
6 "groupId":"face_group_id_1"
7 }响应示例
1HTTP/1.1 200 OK
2 Content-Type: application/json;charset=UTF-8
3 {
4 "error_code":0,
5 "error_msg":"操作成功"
6 }人脸库查询接口
接口描述
查询人脸库列表。
权限说明
请求发起人需要具有合法的根据token接口获取到的token才能发起请求。
请求结构
HTTP方法：POST
请求URL： https://robot.baidu.com/abc-robot/openapi/v1/face-manage/group/query
Header如下：
| 头域 | 类型 | 说明 | 是否必须 |
|---|---|---|---|
| Authorization | String | 填写根据token接口获取到的token | 必须 |
请求参数 Body中放置请求参数，参数详情如下：
| 名称 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| pageNo | int | 查询页数，大小不能小于1 | 必须 |
| pageSize | int | 每页显示数量，范围为1-100 | 必须 |
返回头域 除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| error_code | int | 错误码 |
| error_msg | String | 提示信息 |
| result | Object | 操作结果展示Model |
result的数据类型如下：
| 参数名称 | 类型 | 描述 |
|---|---|---|
| pageSize | int | 每页显示数量 |
| curPage | int | 当前页 |
| totalPage | long | 总页数 |
| totalNumber | long | 总条数 |
| content | Array | 列表内容 |
content的数据类型如下：
| 参数名称 | 类型 | 描述 |
|---|---|---|
| groupId | String | 人脸库ID |
| groupName | String | 人脸库名称 |
| createTime | long | 创建时间 |
| updateTime | long | 更新时间 |
| faceCount | long | 人脸库包含的人脸数量 |
请求示例
1POST HTTP/1.1
2 Host: robot.baidu.com
3 Content-Type: application/json;charset=UTF-8
4 Authorization: authorization string
5 {
6 "pageNo":1
7 "pageSize":15
8 }响应示例
1HTTP/1.1 200 OK
2 Content-Type: application/json;charset=UTF-8
3 {
4 "error_code":0,
5 "error_msg":"操作成功",
6 "result": {
7 "pageSize":15,
8 "curPage":1,
9 "totalPage":1,
10 "totalNumber":1,
11 "content":[
12 {
13 "groupId":"Default",
14 "groupName":"Default",
15 "createTime":1558340478928,
16 "updateTime":1558340478928,
17 "faceCount":1
18 }
19 ]
20 }
21 }