注意
如果因自身业务需要对人脸核身的影像文件进行存储或其他用途,请合作方务必自行保存订单号,通过订单号拉取人脸核身的影像文件是唯一方式。
自拍照+姓名、身份证号模式,即没有比对源的模式,需要合作方上送用户的可信高清正脸照、姓名和身份证号码。在该模式下,系统上送姓名,身份证和合作方上送的高清正脸照到权威数据源,与权威数据源照片进行人脸比对。
合作方生成签名
准备步骤
前置条件:请合作方确保 SIGN ticket 已经正常获取,获取方式请参见 获取 SIGN ticket 。
合作方为人脸核身服务生成签名,需要具有下表中的参数:
参数 | 说明 | 来源 |
appId | 业务流程唯一标识 | |
orderNo | 订单号,字母/数字组成的字符串,本次服务上送的订单号,唯一标识 | 合作方自行分配 |
nonce | 随机数32位随机串(字母+数字组成的随机数) | 合作方自行生成(与接口里定义的随机数保持一致) |
version | 1.0.0 | - |
ticket | 合作伙伴服务端缓存的 ticket,注意是 SIGN 类型 | 获取方式请参见 获取 SIGN ticket |
注意
签名的数据需要与使用该签名接口中的请求参数保持一致。
基本步骤
1. 生成一个32位的随机字符串 nonce(由字母和数字组成,登录时也要用到),将 appId、orderNo、version、ticket、nonce 共5个参数的值进行字典序排序。
2. 将排序后的所有参数字符串拼接成一个字符串进行 SHA1 编码。
3. SHA1 编码后的40位字符串作为签名(sign)。
注意
参考示例
请求参数:
appId = appId001nonce = kHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7T (必须为32位)version = 1.0.0orderNo = aabc1457895464ticket = FxlAe3HFtEy73Um0pJNzIUriwtfnS3KRcPXiesd5ulS4XRAIcT0FbfaP52dwZf5S
字典排序后的参数为:
[1.0.0,FxlAe3HFtEy73Um0pJNzIUriwtfnS3KRcPXiesd5ulS4XRAIcT0FbfaP52dwZf5S, aabc1457895464, appId001,kHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7T]
拼接后的字符串为:
1.0.0FxlAe3HFtEy73Um0pJNzIUriwtfnS3KRcPXiesd5ulS4XRAIcT0FbfaP52dwZf5Saabc1457895464appId001kHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7T
计算 SHA1 得到签名:
该字符串就是最终生成的签名(40位),不区分大小写。
993D057C652D97FD90D5D298F2E5DC4B8D893CBC
自拍照+身份信息模式
请求 URL:https://kyc1.qcloud.com/api/paas/easyface?orderNo=xxx
注意
为方便查询耗时,该请求 url 后面请拼接 orderNo 订单号参数。
请求方法:POST
报文格式:
Content-Type: application/json
请求参数:
参数 | 说明 | 类型 | 长度(字节) | 是否必填 |
appId | 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 | |
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无意义,合作伙伴可忽略,无需处理。