接入文档
人脸搜索(海外版)
API接入
获取人脸库中人脸数量
获取人脸库中人脸数量
# 描述
此接口提供在指定人脸库中查询人脸的总数。
调用URL:
https://api-sgp.yljz.com/finauth/search/group/get_size
# 请求参数
| 是否必选 | 字段 | 类型 | 说明 |
|---|---|---|---|
| 必选 | sign | String | 调用此API客户的签名,具体的签名产生方式请查阅”鉴权说明“文档 |
| 必选 | sign_version | String | 签名算法版本,请传递:hmac_sha1 |
| 必选 | group_id | String | 用户自定义的人脸库标识 |
# 返回值说明
| 字段 | 类型 | 说明 |
|---|---|---|
| face_count | Int | 该库face_token总数量 |
| group_id | String | 用户提供的人脸库标识 |
| request_id | String | 用于区分每一次请求的唯一的字符串。 |
| time_used | Int | 整个请求所花费的时间,单位为毫秒。 |
| error |
String | 当请求失败时才会返回此字符串,具体返回内容见后续错误信息章节。否则此字段不存在。 |
返回值示例
正确请求返回示例
{
"request_id": "1769741218,8c912e9d-aed8-4180-9956-1e994ec4a135",
"time_used": 60,
"group_id": "YuanliStudent_01",
"face_count": 1
}
错误返回示例
{
"request_id": "1769684828,e483ae63-913b-4e32-9068-3719cce59570",
"time_used": 15,
"error": "INVALID_GROUP_ID"
}