接入文档

合作方后台上送身份信息

最近更新时间:2020-11-13 18:06:26

注意:

如果因自身业务需要对人脸核身的影像文件进行存储或其他用途,请合作方务必自行保存订单号,通过订单号拉取人脸核身的影像文件是唯一方式。

生成签名

准备步骤

  • 下载 SDK,请联系您的产品对接专员获取密码。
  • uni 插件接入:https://ext.dcloud.net.cn/plugin?id=1300。
  • 前置条件:请合作方确保 NONCE ticket 已经正常获取,获取方式请参见 获取 NONCE ticket
  • NONCE 类型的 ticket,其有效期为120秒,且一次性有效,即每次启动 SDK 刷脸都要重新请求 NONCE ticket
  • 合作方为人脸核身服务生成签名,需要具有下表中的参数:
参数 说明 来源
wbappid 请添加小助手微信 faceid001,进行线下对接获取 腾讯云线下对接分配
userId 用户唯一标识 合作方自行分配(与 SDK 里定义的 userId 保持一致,不要带有特殊字符)
version 参数值为:1.0.0 -
ticket 合作伙伴服务端实时获取的 ticket,注意是 NONCE 类型 获取方式请参见 获取 NONCE ticket(所用的 userId 参数值需要与 SDK 里面定义 userId 值保持一致)
nonceStr 必须是32位随机数 合作方自行生成(与 SDK 里定义的随机数保持一致,不要带有特殊字符)
注意:

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

基本步骤

  1. 生成一个32位的随机字符串 nonceStr(其为字母和数字,登录时也要用到)。
  2. 将 wbappid、userId、version 连同 ticket、nonceStr 共五个参数的值进行字典序排序。
  3. 将排序后的所有参数字符串拼接成一个字符串。
  4. 将排序后的字符串进行 SHA1 编码,编码后的40位字符串作为签名(sign)。
注意:

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

参考示例

  • 请求参数:
    参数参数值
    wbappid IDAXXXXX
    userIduserID19959248596551
    nonceStrkHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7T
    version1.0.0
    ticketXO99Qfxlti9iTVgHAjwvJdAZKN3nMuUhrsPdPlPVKlcyS50N6tlLnfuFBPIucaMS
  • 字典排序后的参数为:
    [1.0.0, IDAXXXXX, XO99Qfxlti9iTVgHAjwvJdAZKN3nMuUhrsPdPlPVKlcyS50N6tlLnfuFBPIucaMS, kHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7T, userID19959248596551]
  • 拼接后的字符串为:
    1.0.0IDAXXXXXXO99Qfxlti9iTVgHAjwvJdAZKN3nMuUhrsPdPlPVKlcyS50N6tlLnfuFBPIucaMSkHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7TuserID19959248596551
  • 计算 SHA1 得到签名:
    该字符串就是最终生成的签名(40位),不区分大小写。
    D7606F1741DDCF90757DA924EDCF152A200AC7F0

合作方后台上送身份信息

请求

  • 请求 URL:https://idasc.webank.com/api/server/getfaceid
  • 请求方法:POST
  • 报文格式:Content-Type: application/json
  • 请求参数
    参数 说明 类型 长度(字节) 是否必填
    webankAppId 请添加小助手微信 faceid001,进行线下对接获取 String 腾讯云线下对接决定
    orderNo 订单号,由合作方上送,每次唯一,不能超过 32 位 String 不能超过 32 位
    name 姓名 String -
    idNo 证件号码 String -
    userId 用户 ID ,用户的唯一标识(不能带有特殊字符) String -
    sourcePhotoStr 比对源照片,注意:原始图片不能超过500k,且必须为 JPG 或 PNG 格式。
    参数有值:使用合作伙伴提供的比对源照片进行比对,必须注意是正脸可信照片,照片质量由合作方保证。
    参数为空 :根据身份证号 + 姓名使用权威数据源比对
    BASE64String 1048576 否,非必填
    sourcePhotoType 比对源照片类型,参数值为1 时是:水纹正脸照。参数值为 2 时是:高清正脸照 String 1
    version 默认参数值为:1.0.0 String 20
    sign 签名:使用上面生成的签名 String 40

响应

  • 响应示例:
    {
      "code": "0",
      "msg": "请求成功",
      "bizSeqNo": "业务流水号",
      "result": {
          "bizSeqNo": "业务流水号",
          "transactionTime": "20201019110305",
          "orderNo": "合作方订单号",
          "faceId": "175177e03bc53d57222418e18c731488",
          "success": false
      },
      "transactionTime": "20201019110305"
    }
    说明:

    success:false 无意义,合作伙伴可忽略,无需处理。
    faceId 有效期为5分钟,每次进行人脸核身都需要重新获取。