人脸核身 查询核身结果（人脸核身结果查询）

重要提示：

2. 人脸核身完成后的相关业务数据，我们临时为你缓存3天，请根据自身业务所需，务必在3天时效内及时取回，超过3天我们会将业务数据完全清理。

注意：当你的 App 接入的是我们的基础版或增强版 SDK 服务时，SDK 回调中只有当 domain=WBFaceErrorDomainCompareServer 时表示用户完成了刷脸，可以通过查询核身结果接口去拉取刷脸结果。其他 domain 表示用户刷脸中途退出或命中了风控逻辑，查询核身结果接口无法查询到刷脸结果。

一、准备步骤

·前置条件：请合作方确保 SIGN ticket 已经正常获取，获取方式请参见 SIGN ticket获取 。

·合作方为人脸核身服务生成签名，需要具有以下参数：

二、基本步骤

1. 生成一个 32 位的随机字符串nonceStr（其为字母和数字，登录时也要用到）。

2. 将 app_id、order_no、version 连同 ticket、nonceStr 共五个参数的值进行字典序排序。

3. 将排序后的所有参数字符串拼接成一个字符串。

4. 将排序后的字符串进行 SHA1编码，编码后的 40 位字符串作为签名（sign）。

注意：签名算法可参考 签名算法说明 。

三、请求

·请求 URL：https://kyc1.qcloud.com/api/v2/base/queryfacerecord?orderNo=xxx

注意：为方便查询耗时，该请求 url 后面请拼接 orderNo 订单号参数。

·请求方法：POST

·报文格式：Content-Type: application/json

·请求参数：

四、响应

·响应参数：

·响应示例：

{"code":"0","msg":"请求成功","bizSeqNo":"22032920001184453211174015790894","result":{"orderNo":"1617091885609174325769165852","liveRate":"99","similarity":"88.01","occurredTime":"20220329104717","appId":"IDAXXXXX”,”photo”:”******","video":"******","bizSeqNo":"22032920001184453211174015790894","sdkVersion":"1.12.12","trtcFlag":"Y"},"transactionTime":"20220329111740"}

code 非 0 时，有时不返回图片和视频。

注意事项：

·照片和视频信息作为存证，合作伙伴可以通过此接口拉取视频等文件，需要注意请求参数的 get_file 需要设置为 1；如果不上送参数或者参数为空，默认不返回视频和照片信息。为确保用户操作整体流程顺利完成，部分情况下获取视频和照片会有1秒左右的延迟。

·由于照片和视频信息有可能超过 1M，考虑传输的影响，建议合作伙伴在使用时注意，建议获取比对结果用于后续流程处理和存证使用分开调用。避免网络传输带来的影响。目前我们的查询接口是异步查询，返回的文件可能会有1/2 s的延迟。

·如果合作方是完成人脸核身流程后马上去拉取视频/照片，建议在查询接口加上一个查询机制：判断图片是否存在，轮询3次，每次2s。

1.1 照片和视频均为 base64 位编码，其中照片解码后格式一般为 JPG 和 PNG。视频格式解码后一般为 MP4。

1.2 服务端验证结果接口返回66660011无此查询结果的可能原因：

1.2.1 66660017 验证次数超限后被风控，风控后的订单为无效，查询结果为无此查询结果。

1.2.2 用户中途退出刷脸，没有完成人脸验证的流程，没有比对，查询结果为无此查询结果。

1.2.3 66660018 操作超时，请退出重试 无此 ID 的用户身份信息，H5faceid 5分钟有效期，失效后无法进入刷脸流程，查询结果为无此查询结果。

1.2.4 66660016 视频格式或大小不合法 文件或视频不合法，无法进行比对，查询结果为无此查询结果。

1.2.5 400604 上传的视频非实时录制,被时间戳校验拦截，查询结果为无此查询结果(6).查询超过3天的订单返回无此查询结果。

1.3 响应参数请勿做强校验，后续可能会有扩展。

RiskInfo 对象说明

RiskInfo 是用来给合作方传递刷脸风险信息的对象。其中 RiskInfo 对象的字段意义如下表所示：

大模型命中风险描述：