人脸核身
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 人脸核身

自拍照+身份信息识别 API

最近更新时间：2023-10-27 15:22:22

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

合作方生成签名

准备步骤

前置条件：请合作方确保 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 = appId001
nonce = kHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7T (必须为32位)
version = 1.0.0
orderNo = aabc1457895464
ticket = 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无意义，合作伙伴可忽略，无需处理。

中国站