接入文档
人脸搜索(海外版)
API接入
user_id查询人脸信息
user_id查询人脸信息
# 描述
此接口提供传入单个user_id 输出查询列表
# 调用URL:
https://api-sgp.yljz.com/finauth/search/group/user_info
注意:在生产环境中,请使用HTTPS的通信方式。HTTP方式的通信属于不安全链路,存在安全风险,请勿在生产环境中使用。在生产环境中使用HTTP方式的,将无法得到服务可靠性保障。
# 调用方法
POST 注意:用form-data格式请求
# 请求参数
| 是否必选 | 字段 | 类型 | 说明 |
|---|---|---|---|
| 必选 | sign | String | 签名生成规则参考鉴权说明 |
| 必选 | sign_version | String | 签名算法版本,请传递:hmac_sha1 |
| 必选 | group_id | String | 用户自定义的人脸库标识 |
| 必选 | user_id | string | 用户ID |
# 返回值说明
API返回的为一个JSON字符串。
| 字段 | 类型 | 说明 |
|---|---|---|
| request_id | String | 用于区分每一次请求的唯一的字符串。 |
| time_used | Int | 整个请求所花费的时间,单位为毫秒。 |
| infos |
Array | 人脸信息 |
| --face_token | string | 人脸唯一token |
| --user_id | string | 用户id |
| --user_data | string | 用户信息 |
| --add_time | string | 添加时间,毫秒时间戳 |
| error | string | 只有错误时返回,其余不返回该字段 |
返回值示例
正确请求返回示例
{
"request_id": "1783655431,7bfa8dd7-fe1f-44c8-99df-59b22c4e9434",
"time_used": 185,
"infos": [
{
"face_token": "75932a4a4b090b7c0a87b9452de2e0ff",
"user_id": "user_01",
"user_data": "测试用户",
"add_time": 1783653968086
},
{
"face_token": "6e1f617325fef1c5ca1e538beba3c59a",
"user_id": "user_01",
"user_data": "测试用户",
"add_time": 1783654676716
},
{
"face_token": "bfff09553f3700a1aadeea91d1d92ac5",
"user_id": "user_01",
"user_data": "测试用户",
"add_time": 1783654692663
},
{
"face_token": "d424506e339748c7f23b15d75cfe3de1",
"user_id": "user_01",
"user_data": "测试用户",
"add_time": 1783654696705
},
{
"face_token": "1e172d662d97cfb2672ec186cd213b66",
"user_id": "user_01",
"user_data": "测试用户",
"add_time": 1783654715062
}
]
}
错误返回示例
{
"request_id": "1769743204,37ddf07b-c640-4199-ba17-3d13a2059e50",
"time_used": 55,
"error": "INVALID_FACE_TOKEN"
}
# error错误信息
| HTTP状态代码 | 错误信息 | 说明 |
|---|---|---|
| 400 | INVALID_FACE_TOKEN | face_token错误 |