腾讯云人脸核身意愿核身查询结果_AI解决方案_同尘科技
合作伙伴服务端验证结果
此方式用于合作伙伴服务端生成签名,并调用意愿核身服务端查询结果,鉴权完成后返回结果(服务端上送 orderNo 和 appId 查询)。
合作方后台生成签名
准备步骤
1. 前置条件:
请合作方确保 SIGN ticket 已经正常获取,获取方式见 获取 SIGN ticket。2. 合作方为意愿核身查询服务生成签名,需要具有以下参数:
参数 | 说明 | 来源 |
appId | 腾讯服务分配的 Appid | 参考 获取 WBappid 指引在意愿核身控制台内申请 |
orderNo | 订单号,本次意愿核身合作伙伴上送的订单号,唯一标识,字母/数字组成的字符串 | 合作方自行分配 |
version | 默认值:1.0.0 | – |
ticket | 合作伙伴服务端缓存的 ticket,注意是 SIGN 类型 | 获取方式见 获取 SIGN ticket |
nonceStr | 32 位随机字符串,字母和数字 | 合作方自行生成 |
基本步骤
1. 生成一个 32 位的随机字符串 nonceStr(其为字母和数字,登录时也要用到)。2. 将 appId、orderNo、version 连同 ticket、nonceStr 共五个参数的值进行字典序排序。3. 将排序后的所有参数字符串拼接成一个字符串。4. 将排序后的字符串进行 SHA1 编码,编码后的 40 位字符串作为签名(sign)。注意 签名算法可参考 签名算法说明 。
识别结果查询接口
请求 URL:https://miniprogram-kyc.tencentcloudapi.com/api/server/getWillFaceResult?orderNo=xxxx
请求方法:POST报文格式:Content-Type: application/json
请求参数:
参数 | 说明 | 类型 | 长度(字节) | 是否必填 |
appId | 腾讯服务分配的 Appid | 字符串 | 腾讯服务分配 | 是 |
orderNo | 订单号,合作方订单的唯一标识,字母/数字组成的字符串 | 字符串 | 32 | 是 |
nonce | 随机数 | 字符串 | 32 | 是 |
version | 版本号,默认值:1.0.0 | 字符串 | 20 | 是 |
sign | 签名值,使用本页第一步生成的签名 | 字符串 | 40 | 是 |
getFile | 是否需要获取人脸识别的视频和文件,值为1则返回视频和照片、值为2则返回照片、值为3则返回视频;其他则不返回 | 字符串 | 40 | 是 |
getWillFile | 是否需要获取意愿表达的音频文件,默认值为1,值为1-返回,其他值为不返回 | 字符串 | 40 | 是 |
响应参数:
参数 | 类型 | 说明 |
code | String | 0代表成功 |
msg | String | 返回结果描述 |
faceCode | String | 人脸核身结果 |
faceMsg | String | 人脸核身结果描述 |
willCode | String | 意愿表达结果 |
willMsg | String | 意愿表达结果描述 |
bizSeqNo | String | 业务流水号 |
transactionTime | String | 请求接口的时间 |
orderNo | String | 订单编号 |
liveRate | String | 活体检测得分 |
similarity | String | 人脸比对得分 |
occurredTime | String | 进行刷脸的时间 |
photo | String | 意愿核身时的照片,base64 位编码 |
video | String | 意愿核身时的视频,base64 位编码 |
appId | String | 腾讯云控制台申请的 appid |
willUserAudio | String | 意愿核身用户音频 意愿表达阶段的音频文件,base64位编码 |
willReadAudio | String | 意愿核身播报音频 意愿表达阶段的音频文件,base64位编码 |
willUserVideo | String | 意愿核身完整视频:从用户播报音频到回复音频过程,base64位编码 |
willScrnShotImage | String | 意愿表达阶段的屏幕画面图,base64位编码 |
willStandText | String | 客户初始化上送的文字信息 |
willStandAnswer | String | 客户初始化上送的答案文字信息 |
willUserAnswer | String | 识别结果文本信息 |
{ "code": "0", "msg": "请求成功", "bizSeqNo": "22071420001184453211072324316763", "result": { "bizSeqNo": "22071420001184453211072324316763", "transactionTime": "20220714110723", "appId": "IDAXXXXX", "orderNo": "13213545132", "similarity": "94.94", "liveRate": "99", "occurredTime": "20220714110147", "faceCode": "0", "faceMsg": "请求成功", "willCode": "0", "willMsg": "请求成功", "willUserAudio": "UklGRiR2AgBXQVZFZm10IBAAAAABAAIAQB8AAAB9AAAEABAAZGF0YQB2AgAAAAAAAAACAAgAGwA7AFEA", "willReadAudio": "UklGRqRIBQBXQVZFZm10IBAAAAABAAEAgD4AAAB9AAACABAAZGF0YYBIBQAAAAAAAAAAAAAAAAAAAAAAAAAA", "willUserVideo": "AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAOLGttZGF0AAACXQYF//9Z3EXpve", "willStandText": "本人知情以下号码开户,知晓出售、出租、转让等方式提供电话卡供他人使用的法律风险.。请回答:同意", "willStandAnswer": "嗯|好的|是的", "willUserAnswer": "是的", "trtcFlag": "Y", "success": false }, "transactionTime": "20220714110723"}
注意事项
code 非0时,有时不返回图片和视频。照片和视频信息作为存证,合作伙伴可以通过此接口拉取视频等文件,需要注意请求参数的 get_file 需要设置为 1;如果不上送参数或者参数为空,默认不返回视频和照片信息。为确保用户操作整体流程顺利完成,部分情况下获取视频和照片会有1秒左右的延迟。由于照片和视频信息有可能超过 1M,考虑传输的影响,建议合作伙伴在使用时注意,建议获取比对结果用于后续流程处理和存证使用分开调用。避免网络传输带来的影响。目前我们的查询接口是异步查询,返回的文件可能会有1~2s的延迟。如果合作方是完成意愿核身流程后马上去拉取视频/照片,建议在查询接口加上一个查询机制:判断图片是否存在,轮询3次,每次2s。照片和视频均为 base64 位编码,其中照片解码后格式一般为 JPG 和 PNG。视频格式解码后一般为 MP4。服务端验证结果接口返回66660011无此查询结果的可能原因:66660017 验证次数超限后被风控,风控后的订单为无效,查询结果为无此查询结果。用户中途退出刷脸,没有完成人脸验证的流程,没有比对,查询结果为无此查询结果。操作超时,请退出重试 无此 ID 的用户身份信息,faceid 5分钟有效期,失效后无法进入刷脸流程,查询结果为无此查询结果。视频格式或大小不合法 文件或视频不合法,无法进行比对,查询结果为无此查询结果。上传的视频非实时录制,被时间戳校验拦截,查询结果为无此查询结果。查询超过3天的订单返回无此查询结果。响应参数请勿做强校验,后续可能会有扩展。
服务响应码
详情请参见 SaaS 服务错误码。
对解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案
暂无评论,你要说点什么吗?