查询人脸认证结果
人脸比对流程，开发者后台调用此接口请求飞书后台，对本次活体比对结果做校验，支持查询有源认证与无源认证结果。
Note 人脸比对接入需申请白名单，接入前请联系飞书开放平台工作人员，邮箱：open-platform@bytedance.com。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/face_verify/v1/query_auth_result |
| HTTP Method | GET |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token |
| Content-Type | string | 是 | 固定值："application/json; charset=utf-8" |
查询参数
| 参数 | 格式 | 必须 | 说明 | 类型 |
|---|---|---|---|---|
| req_order_no | string | 是 | 人脸识别单次唯一标识，由tt.startFaceVerify接口返回 | URL参数 |
| open_id | string | 否 | 用户应用标识, 与employee_id二选其一 | URL参数 |
| employee_id | string | 否 | 用户租户标识, 与open_id二选其一 | URL参数 |
| ticket_type | string | 否 | 认证方式标识，可取值'verify'或空; verify表示查询有源认证结果,缺省表示查询无源认证结果 | URL参数 |
Note
open_id和employee_id（也称user_id）的获取方式可以参考文档：如何获取不同的用户 ID
响应
响应体
| 参数 | 说明 |
|---|---|
| code | 返回码，非0为失败 |
| msg | 返回信息，返回码的描述 |
| data | 业务数据 |
| ∟auth_state | 认证结果, 0: 认证中, 1: 认证成功, -1: 认证失败 |
| ∟auth_timpstamp | 认证时间，unix 时间戳 |
响应体示例
json
{
"code": 0,
"msg": "ok",
"data":{
"auth_state": 0/1/-1,
"auth_timestamp": 1559714887
}
}错误码
| 错误码 | 描述 | 排查建议 |
|---|---|---|
| 10100 | invalid request | 检查参数是否为空，权限是否接入 |
| 10101 | internal error | 建议重试 |