文档中心 人脸核身 接入文档 API 接入 自拍照+身份信息识别 API

自拍照+身份信息识别 API

最近更新时间:2019-08-21 17:16:07

自拍照+姓名、身份证号模式,即没有比对源的模式,需要合作方上送用户的可信高清正脸照、姓名和身份证号码。在该模式下,系统通过姓名和身份证号码拉取可信比对源,与上送的照片进行人脸比对。

合作方生成签名

准备步骤

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

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

基本步骤

  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/easyface

  • 请求方法:POST

  • 报文格式:Content-Type: application/json

  • 请求参数:

    参数说明类型长度(字节)是否必填
    webankAppId分配给服务使用方的 AppIdString腾讯云线下对接决定
    nonce32位随机数String32
    version1.0.0String20
    sign生成算法请参见 签名算法说明String40
    orderNo订单号,由合作方上送,每次唯一String32
    name姓名String20
    idNo证件号码String20
    userId用户 ID ,用户的唯一标识(不要带有特殊字符)String32
    photoStr照片文件
    注意:原始图片不能超过2MB,且必须为 JPG 或 PNG 格式
    Base64 String不超过3MB
    photoType 比对源照片类型
    • 参数值为 1 时:photoStr 为身份证正面照,逻辑处理会去抠身份证头像后再去比对。
    • 参数值为 null 或其他:photoStr 为其他类型的照片,直接使用上送的图片去做比对。
    String1
  • 响应参数:

    参数类型说明
    codeString0:成功
    非0:失败
    详情请参见 错误码
    msgString请求结果描述
    bizSeqNoString请求业务流水号
    orderNoString订单编号
    similarityString图片的相似度比对得分