腾讯云人脸核身自拍照+身份信息识别 API_AI解决方案_同尘科技
注意如果因自身业务需要对人脸核身的影像文件进行存储或其他用途,请合作方务必自行保存订单号,通过订单号拉取人脸核身的影像文件是唯一方式。自拍照+姓名、身份证号模式,即没有比对源的模式,需要合作方上送用户的可信高清正脸照、姓名和身份证号码。在该模式下,系统上送姓名,身份证和合作方上送的高清正脸照到权威数据源,与权威数据源照片进行人脸比对。
合作方生成签名
准备步骤
前置条件:请合作方确保 SIGN ticket 已经正常获取,获取方式请参见 获取 SIGN ticket 。合作方为人脸核身服务生成签名,需要具有下表中的参数:
参数 | 说明 | 来源 |
WBappid | 业务流程唯一标识 | 参考 获取 WBappid 指引在人脸核身控制台内申请 |
orderNo | 订单号,字母/数字组成的字符串,本次服务上送的订单号,唯一标识 | 合作方自行分配 |
nonce | 随机数32位随机串(字母+数字组成的随机数) | 合作方自行生成(与接口里定义的随机数保持一致) |
version | 1.0.0 | – |
ticket | 合作伙伴服务端缓存的 ticket,注意是 SIGN 类型 | 获取方式请参见 获取 SIGN ticket |
注意 签名的数据需要与使用该签名接口中的请求参数保持一致。
基本步骤
1. 生成一个32位的随机字符串 nonce(由字母和数字组成,登录时也要用到),将 WBappid、orderNo、version、ticket、nonce 共5个参数的值进行字典序排序。2. 将排序后的所有参数字符串拼接成一个字符串进行 SHA1 编码。3. SHA1 编码后的40位字符串作为签名(sign)。注意签名算法可参考 签名算法说明 。
参考示例
请求参数:
WBappid = appId001nonce = kHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7T (必须为32位)version = 1.0.0orderNo = aabc1457895464ticket = FxlAe3HFtEy73Um0pJNzIUriwtfnS3KRcPXiesd5ulS4XRAIcT0FbfaP52dwZf5S
字典排序后的参数为:
[1.0.0,FxlAe3HFtEy73Um0pJNzIUriwtfnS3KRcPXiesd5ulS4XRAIcT0FbfaP52dwZf5S, aabc1457895464, appId001,kHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7T]
拼接后的字符串为:
1.0.0FxlAe3HFtEy73Um0pJNzIUriwtfnS3KRcPXiesd5ulS4XRAIcT0FbfaP52dwZf5Saabc1457895464appId001kHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7T
计算 SHA1 得到签名:
该字符串就是最终生成的签名(40位),不区分大小写。
993D057C652D97FD90D5D298F2E5DC4B8D893CBC
自拍照+身份信息模式
请求 URL:https://miniprogram-kyc.tencentcloudapi.com/api/paas/easyface?orderNo=xxx注意为方便查询耗时,该请求 url 后面请拼接 orderNo 订单号参数。请求方法:POST报文格式:Content-Type: application/json
请求参数:
参数 | 说明 | 类型 | 长度(字节) | 是否必填 |
appId | 业务流程唯一标识,即 WBappid,可参考 获取 WBappid 指引在人脸核身控制台内申请 | String | 8 | 是 |
nonce | 32位随机数 | String | 32 | 是 |
version | 1.0.0 | String | 20 | 是 |
sign | 生成算法请参见 签名算法说明 | String | 40 | 是 |
orderNo | 订单号,字母/数字组成的字符串,由合作方上送,每次唯一 | String | 32 | 是 |
name | 姓名 | String | 20 | 是 |
idNo | 证件号码 | String | 20 | 是 |
userId | 用户 ID ,用户的唯一标识(不要带有特殊字符) | String | 32 | 否 |
photoStr | 高清自拍照片注意:图片base64后不能超过20MB,且必须为 JPG 或 PNG、BMP 格式 | Base64 String | 不超过20MB | 是请使用标准的图片转base64方法,base64编码不可包含换行符,不需要加前缀 |
响应参数:
参数 | 类型 | 说明 |
code | String | 0:成功非0:失败详情请参见 SaaS 服务错误码 |
msg | String | 请求结果描述 |
bizSeqNo | String | 请求业务流水号 |
transactionTime | String | 请求接口的时间 |
orderNo | String | 订单编号 |
similarity | String | 图片的相似度比对得分 |
响应示例:
{ "code": "0", "msg": "请求成功", "bizSeqNo": "21062120001184415714222706920349", "result": { "bizSeqNo": "21062120001184415714222706920349", "transactionTime": "20210621142227", "orderNo": "93ysc4s1a6se8gv7vjcrq27w17j9825n", "sc": "A", "similarity": "90.27", " success ": false }, "transactionTime": "20210621142227"}
说明success:false;sc:A无意义,合作伙伴可忽略,无需处理。
对解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案
暂无评论,你要说点什么吗?