查询用户人脸列表
更新时间: 2025/03/05 16:07:31接口说明
查询一个用户的全部人脸列表。
接口URL
https://sdk.cloudroom.com/CLOUDMEETING-API/v1/face/query/list
请求方式:POST
请求参数
Header
| 名称 | 参数值 | 是否必传 | 说明 |
|---|---|---|---|
| Content-Type | application/json | 是 | 请求头 |
Body
接口参数
| 参数名称 | 类型 | 是否必传 | 说明 |
|---|---|---|---|
| GroupId | String | 是 | 用户组id |
| PersonId | String | 是 | 用户id |
返回参数
| 名称 | 类型 | 说明 |
|---|---|---|
| RspCode | Integer | 错误码 |
| RspDesc | String | 描述 |
| Data | Map | 数据集合 |
Data参数说明:
| 名称 | 类型 | 说明 |
|---|---|---|
| FaceCount | Integer | 人脸总数量 |
| FaceList | List | 人脸列表 |
| - FaceId | String | 人脸图片id |
| - CreateTime | Long | 人脸创建时间,Unix时间戳 |
示例
请求示例
curl -X POST https://sdk.cloudroom.com/CLOUDMEETING-API/v1/face/query/list \
-H "Content-Type: application/json" \
-d '{
"RequestId": "2d95a5fe-a384-5dea-0d84-db153b10ee0f",
"CompID": "1",
"SecretKey": "a7febff6a21c36fb50150f88c95ef641",
"AppId": "demo",
"GroupId":"test_group_1",
"PersonId":"1001"
}'
返回示例
{
"RspCode":0,
"RspDesc":"请求成功",
"Data":{
"FaceList": [
{
"CreateTime": 1730255163,
"FaceId": "43bc9ec06d664871b6571dcacdfb1663"
},
{
"CreateTime": 1730255150,
"FaceId": "e6669adedce44829af833c6f68e8d267"
},
{
"CreateTime": 1730255139,
"FaceId": "c0807578ea3547af974cc64a73687077"
}
],
"FaceCount": 3
}
}
错误码
上述接口在 Body 中返回请求的错误码,详情请参见 错误码