查询个人刷脸状态

更新时间:2025-09-15 15:40:53

接口描述

查询个人刷脸认证结果,建议该接口的业务场景放在用户刷脸之后,再调用该接口进行查询

接口

/v2/identity/auth/pub/individual/{flowId}/face

请求方式

GET

请求头

提供两种安全接入方式,对应参数如何获取,参考文档【请点击】。

请求参数

参数名称

类型

必选

参数类型

参数说明

flowId

string

path

发起刷脸时的id

响应参数

展开全部参数参数名称

类型

必选

参数说明

code

int

接口响应结果码

message

string

接口响应结果描述

data

object

接口响应结果数据

status

string

刷脸结果状态

ING - 刷脸地址已申请

SCAN - 刷脸地址已使用,但尚未接收到刷脸结果(仅限e签宝认证服务网页版PC端展示二维码,手机扫码刷脸场景)

SUCCESS - 刷脸认证通过

FAIL - 刷脸认证失败

message

string

刷脸结果描述

similarity

string

刷脸照片相似度得分(目前腾讯云刷脸和快捷刷脸才会返回具体值)

livingScore

string

刷脸活体检测得分(目前腾讯云刷脸和快捷刷脸才会返回具体值)

请求示例  

GET /v2/identity/auth/pub/individual/30611111112327207/face HTTP/1.1

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "livingScore": "99.0",
        "similarity": "95.25",
        "status": "SUCCESS",
        "message": "认证成功"
    }
}

错误码

错误码

错误描述

解决方案

30500000

操作出错,请联系服务人员处理

请核实flowId是否是通过发起刷脸认证接口获取

30500001

认证流程不存在

flowId在e签宝系统中不存在,检查flowId是否正确设置

30503055

未查询到刷脸认证记录

请传入正确的flowId


我要纠错