人脸识别

查询用户人脸列表

更新时间: 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 中返回请求的错误码,详情请参见 错误码