# 描述

查询已建人脸库的列表

调用URL：

https://api-sgp.yljz.com/finauth/search/group/group_list

测试环境：

# 请求参数

	参数名	类型	参数说明
必选	sign	String	调用此API客户的签名，具体的签名产生方式请查阅App-鉴权说明
必选	sign_version	String	签名算法版本，请传递：hmac_sha1

# 返回值说明

字段路径	类型	说明
requestid	String	用于区分每一次请求的唯一的字符串，此字符串可以用于后续数据反查。此字段必定返回
model_version	String	人脸识别所用的算法模型版本。示例值：s21
group_id	String	用户自定义的人脸库的唯一标识，如果未定义则返回值为空
group_name	String	人脸库名称
group_data	String	人脸库信息
add_time	string	创建时间
error	String	当出现错误时会返回此字符串，具体返回内容见后续错误信息章节。否则此字段不存在。
time_used	Int	整个请求所花费的时间，单位为毫秒。除非发生404（API_NOT_FOUND )或403 （AUTHORIZATION_ERROR）错误，此字段必定返回

正确请求返回示例

{
    "request_id": "1772532811,965b2850-1bbb-4d87-a59a-c6cfd0cfa230",
    "time_used": 59,
    "group_infos": [
        {
            "group_id": "Finauth_test_001",
            "group_name": "测试用户集001",
            "group_data": "",
            "model_version": "s21",
            "add_time": "2026-01-27T14:19:01+08:00"
        },
        {
            "group_id": "Finauth_test_002",
            "group_name": "测试用户集002",
            "group_data": "",
            "model_version": "s21",
            "add_time": "2026-01-27T19:42:47+08:00"
        },
        {
            "group_id": "YuanliStudent_test_01",
            "group_name": "旷视实习生库_01",
            "group_data": "旷视实习生人脸库，用户存放人脸信息",
            "model_version": "s21",
            "add_time": "2026-02-05T11:17:45+08:00"
        }
    ]
}