腾讯云人脸核身自拍照+身份信息识别 API_AI解决方案_同尘科技

人脸核身 1年前 (2023-10-27) 浏览 66

注意如果因自身业务需要对人脸核身的影像文件进行存储或其他用途,请合作方务必自行保存订单号,通过订单号拉取人脸核身的影像文件是唯一方式。自拍照+姓名、身份证号模式,即没有比对源的模式,需要合作方上送用户的可信高清正脸照、姓名和身份证号码。在该模式下,系统上送姓名,身份证和合作方上送的高清正脸照到权威数据源,与权威数据源照片进行人脸比对。

合作方生成签名

准备步骤

前置条件:请合作方确保 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折起,即将结束: 马上收藏

同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠

阿里云解决方案也看看?: 点击对比阿里云的解决方案

- 0人点赞 -

发表点评 (0条)

not found

暂无评论,你要说点什么吗?