查询个人刷脸状态
接口描述
- 查询个人刷脸认证结果
接口地址
/v2/identity/auth/pub/individual/{flowId}/face
请求方式
- GET
- 请求报文体采用Json数据格式，编码方式采用UTF-8编码
请求参数
| 参数名 | 说明 | 参数类型 | 是否必填 | 类型 |
|---|---|---|---|---|
| flowId | 发起刷脸时的id | path | 是 | string |
请求示例
GET /v2/identity/auth/pub/individual/836551334533533698/face HTTP/1.1
响应参数
| 参数名 | 说明 | 类型 |
|---|---|---|
| code | int | 接口响应结果码 |
| message | string | 接口响应结果描述 |
| data | object | 接口响应结果数据 |
| status | string | 刷脸结果状态,详见: 个人刷脸结果状态对照表 |
| message | string | 刷脸结果描述 |
| similarity | string | 刷脸照片相似度得分（目前腾讯云刷脸才有） |
| livingScore | string | 刷脸活体检测得分（目前腾讯云刷脸才有） |
响应示例
{
"code": 0,
"message": "成功”,
"data":{
"livingScore':"",
"similarity":"",
"status": "FINISH",
"message": "已完成"
}
}
错误码
| 错误码 | 错误信息 | 错误原因 |
|---|---|---|
| 30500001 | 认证流程不存在 | flowId在e签宝系统中不存在,检查flowId是否正确设置 |
| 30503055 | 刷脸查询失败, 请确认参数正确 | 指定flowId未发起过刷脸 |