生成签名
准备步骤
前置条件：请合作方确保 SIGN ticket 已经正常获取，获取方式见 获取 SIGN ticket。
SIGN 类型的 ticket，其有效期为60分钟，且可多次使用。
合作方为人脸核身服务生成签名，需要具有以下参数：
参数 | 说明 | 来源 |
appId | 业务流程唯一标识 | |
userId | 用户唯一标识 | 合作方自行分配，需跟用户绑定，32位以内，不包含特殊字符 |
version | 参数值为：1.0.0 | - |
ticket | 合作伙伴服务端获取的 ticket，注意是 SIGN 类型 | |
nonce | 必须是32位随机数 | 合作方自行生成 |
注意：
参与签名的数据需要与使用该签名的接口中的请求参数保持一致。
基本步骤
1. 生成一个32位的随机字符串 nonce（其为字母和数字，登录时也要用到）。
2. 将 nonce、userId、appId 连同 ticket、version 共五个参数的值进行字典序排序。
3. 将排序后的所有参数字符串拼接成一个字符串。
4. 将排序后的字符串进行 SHA1 编码，编码后的40位字符串作为签名（sign）。
注意：
参考示例
请求参数：
参数 | 参数值 |
appId | IDAXXXXX |
userId | userID19959248596551 |
nonce | kHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7T |
version | 1.0.0 |
ticket | XO99Qfxlti9iTVgHAjwvJdAZKN3nMuUhrsPdPlPVKlcyS50N6tlLnfuFBPIucaMS |
字典排序后的参数为：
[1.0.0, IDAXXXXX, XO99Qfxlti9iTVgHAjwvJdAZKN3nMuUhrsPdPlPVKlcyS50N6tlLnfuFBPIucaMS, kHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7T, userID19959248596551]
拼接后的字符串为：
1.0.0IDAXXXXXXO99Qfxlti9iTVgHAjwvJdAZKN3nMuUhrsPdPlPVKlcyS50N6tlLnfuFBPIucaMSkHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7TuserID19959248596551
计算 SHA1 得到签名：
该字符串就是最终生成的签名（40位），不区分大小写。
D7606F1741DDCF90757DA924EDCF152A200AC7F0
合作方后台上送身份信息
请求
请求 URL：https:// kyc1.qcloud.com/api/server/ getPlusFaceId?orderNo=xxx
注意：
为方便查询耗时，该请求 url 后面请拼接 orderNo 订单号参数。
请求方法：POST
报文格式：Content-Type: application/json
请求参数：
参数 | 说明 | 类型 | 长度（字节） | 是否必填 |
appId | String | 8 | 是 | |
orderNo | 订单号，字母/数字组成的字符串，由合作方上送，每次唯一，不能超过32位 | String | 不能超过 32 位 | 是 |
name | 姓名 | String | - | 使用权威源比对时：姓名+证件号 必须输入使用自带源比对时：姓名+证件号 可不输入 |
idNo | 证件号码 | String | - | 使用权威源比对时：姓名+证件号 必须输入使用自带源比对时：姓名+证件号 可不输入 |
userId | 用户 ID ，用户的唯一标识（不能带有特殊字符），需要跟生成签名的 userId 保持一致 | String | 不能超过 32 位 | 是 |
sourcePhotoStr | 比对源照片，注意：原始图片不能超过500k，且必须为 JPG 或 PNG、BMP 格式。参数有值：使用合作伙伴提供的比对源照片进行比对，必须注意是正脸可信照片，照片质量由合作方保证参数为空 ：根据身份证号 + 姓名使用权威数据源比对 | BASE64 String | 1048576 | 否，非必填请使用标准的图片转base64方法，base64编码不可包含换行符，不需要加前缀 |
sourcePhotoType | 比对源照片类型参数值为1 时是：水纹正脸照参数值为 2 时是：高清正脸照 重要提示：照片上无水波纹的为高清照，请勿传错，否则影响比对准确率。如有疑问，请联系腾讯云技术支持线下确认 | String | 1 | 否，提供比对源照片需要传 |
liveInterType | 活体交互模式 参数值为1时，表示仅使用实时检测模式，不兼容的情况下回调错误码3005； 参数值非1或不入参，表示优先使用实时检测模式，如遇不兼容情况，自动降级为视频录制模式。 | String | 1 | 否 |
version | 默认参数值为：1.0.0 | - | 20 | 是 |
sign | 签名：使用上面生成的签名 | String | 40 | 是 |
nonce | 随机数 | - | 32 | 是 |
水纹照示例
响应
响应示例
{"code":"0","msg":"请求成功","bizSeqNo":"21062120001184438418322908010297","result":{"bizSeqNo":"21062120001184438418322908010297","transactionTime":"20210621183229","orderNo":"1617091885609174325769165850","faceId":"tx0375fa5243984381ea7b7013f13795","optimalDomain":"kyc1.qcloud.com","success":false},"transactionTime":"20210621183229"
说明：
success：false 无意义，合作伙伴可忽略，无需处理。
faceId 有效期为5分钟，每次进行人脸核身都需要重新获取。
