接入文档
人脸搜索（海外版）
API接入
获取人脸库中人脸信息
获取人脸库中人脸信息
# 描述
此接口提供传入单个face_token 输出user_data
调用URL：
https://api-sgp.yljz.com/finauth/saech/group/face_info
# 请求参数
| 是否必选 | 字段 | 类型 | 说明 |
|---|---|---|---|
| 必选 | sign | String | 调用此API客户的签名，具体的签名产生方式请查阅”鉴权说明“文档 |
| 必选 | sign_version | String | 签名算法版本，请传递：hmac_sha1 |
| 必选 | group_id | String | 用户自定义的人脸库标识 |
| 必选 | face_token | string | 人脸唯一token |
# 返回值说明
API返回的为一个JSON字符串。
| 字段 | 类型 | 说明 |
|---|---|---|
| info |
map | 人脸信息 |
| face_token | string | 人脸唯一token |
| user_id | string | 用户id |
| user_data | string | 用户信息 |
| add_time | string | 添加时间，毫秒时间戳 |
| time_used | Int | 整个请求所花费的时间，单位为毫秒。 |
| request_id | String | 用于区分每一次请求的唯一的字符串。 |
| error | String | 当请求失败时才会返回此字符串，具体返回内容见后续错误信息章节。否则此字段不存在。 |
返回值示例
正确请求返回示例
{
"request_id": "1769743445,07c4bb36-5858-4290-83ef-97c65db691aa",
"time_used": 48,
"info": {
"face_token": "9eab9fe14a402295fb78409a81abfc3c",
"user_id": "user_01",
"user_data": "测试用户",
"add_time": 1769739690208
}
}
错误返回示例
{
"request_id": "1769743204,37ddf07b-c640-4199-ba17-3d13a2059e50",
"time_used": 55,
"error": "INVALID_FACE_TOKEN"
}
# error_message错误信息
| HTTP状态代码 | 错误信息 | 说明 |
|---|---|---|
| 400 | INVALID_FACE_TOKEN | face_token错误 |