接入文档
人脸搜索(海外版)
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错误