自拍照+比对照模式

最近更新时间:2019-07-03 10:42:53

自拍照+比对照模式,需要合作方上送用户的高清照和比对照片。在该模式下,系统通过两张照片的比对,返回两张照片相似度得分。

合作方生成签名

准备步骤

  • 前置条件:请合作方确保 SIGN ticket 已经正常获取,获取方式请参见 SIGN ticket 获取
  • 合作方为人脸核身服务生成签名,需要具有下表中的参数:
参数 说明 来源
appId 腾讯服务分配的 AppID 腾讯云线下对接分配
orderNo 订单号,本次服务上送的订单号,唯一标识 合作方自行分配
nonce 随机数32位随机串(字母+数字组成的随机数) 合作方自行生成(与接口里定义的随机数保持一致)
version 1.0.0 -
api ticket 合作伙伴服务端缓存的 tikcet,注意是 SIGN 类型 获取方式请参见 SIGN ticket 获取

注意:

签名的数据需要与使用该签名的 SDK 中的请求参数保持一致。

基本步骤

  1. 生成一个32位的随机字符串 nonce(由字母和数字组成,登录时也要用到),将 webankAppId、orderNo、version、ticket、nonce 共5个参数的值进行字典序排序。
  2. 将排序后的所有参数字符串拼接成一个字符串进行 SHA1 编码。
  3. SHA1 编码后的40位字符串作为签名(sign)。

    注意:

    签名算法可参考 签名算法说明

参考示例

  • 请求参数:
    webankAppId= 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://ida.webank.com/api/paas/easycompare
  • 请求方法:POST
  • 报文格式:Content-Type: application/json
  • 请求参数:
    参数说明类型长度(字节)是否必填
    webankAppId分配给服务使用方的 AppIdString腾讯云线下对接决定
    nonce32位随机数String32
    version1.0.0String20
    sign生成算法请参见 签名算法说明String40
    orderNo订单号,由合作方上送,每次唯一String32
    antiAttack活体检测增强功能,值为true/false
    不上送或值为false:不对上送的图片进行翻拍活体检测
    值为true:对上送的图片进行翻拍活体检测,会增加耗时
    Boolean-
    name姓名String20
    idNo证件号码String20
    userId用户 ID ,用户的唯一标识(不要带有特殊字符)String32
    photoStr照片文件
    注意:原始图片不能超过2M,且必须为 JPG 或 PNG 格式
    Base64 String不超过3M
    sourcePhotoStr合作伙伴自己提供的可信比对源照片
    注意:原始图片不能超过500KB,且必须为 JPG 或 PNG 格式
    Base64 String不超过1MB
    sourcePhotoType比对源照片类型:
    • 值为1:网纹照
    • 值为2:高清照
    String1
  • 响应参数:
    参数类型说明
    codeString0:成功
    非0:失败
    详情请参见 通用响应码
    msgString请求结果描述
    bizSeqNoString请求业务流水号
    orderNoString订单编号
    similarityString图片的相似度比对得分