接入文档
人脸搜索(海外版)
API接入
获取人脸库详情
获取人脸库详情
# 描述
查询人脸库的详情信息
调用URL:
https://api-sgp.yljz.com/finauth/search/group/group_info
测试环境:
# 请求参数
| 参数名 | 类型 | 参数说明 | |
|---|---|---|---|
| 必选 |
sign |
String | 调用此API客户的签名,具体的签名产生方式请查阅App-鉴权说明 |
| 必选 | sign_version | String | 签名算法版本,请传递:hmac_sha1 |
| 必选 | group_id | String | 人脸库 ID |
# 返回值说明
| 字段路径 | 类型 | 说明 |
|---|---|---|
| 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": "1772530321,13109482-5119-4ac5-981e-ef4b06aa10bd",
"time_used": 159,
"info": {
"group_id": "YuanliStudent_test_01",
"group_name": "旷视实习生库_01",
"group_data": "旷视实习生人脸库,用户存放人脸信息",
"model_version": "s21",
"add_time": "2026-02-05T11:17:45+08:00"
}
}
错误返回示例
{
"request_id": "1769684042,e043ea9c-92c9-4c1e-8af4-8198da8ac6c1",
"time_used": 17,
"error": "GROUP_EXIST"
}
# error_message错误信息
当前 API 特有的 ERROR_MESSAGE
| HTTP状态代码 | 错误信息 | 说明 |
|---|---|---|
| 400 | INVALID_OUTER_ID | 人脸库不存在 |