合作方后台上送身份信息

最近更新时间:2019-08-13 14:18:10

生成签名

准备步骤

  • 下载 SDK,请联系您的产品对接专员获取密码。
  • 前置条件:请合作方确保 NONCE ticket 已经正常获取,获取方式请参见 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. 将 appId、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.0 IDAXXXXXXO99Qfxlti9iTVgHAjwvJdAZKN3nMuUhrsPdPlPVKlcyS50N6tlLnfuFBPIucaMSkHoSxvLZGxSoFsjxlbzEoUzh5PAnTU7TuserID19959248596551
  • 计算 SHA1 得到签名:
    该字符串就是最终生成的签名(40位),不区分大小写。
    D7606F1741DDCF90757DA924EDCF152A200AC7F0

合作方后台上送身份信息

请求

  • 请求 URL:https://idasc.webank.com/api/server/getfaceid
  • 请求方法:POST
  • 报文格式:Content-Type: application/json
  • 请求参数
    参数 说明 类型 长度(字节) 是否必填
    webankAppId 腾讯云线下对接分配的 App ID 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": "成功",
    "result": {
         "bizSeqNo":"业务流水号",
         "orderNo":"合作方订单号",
         "faceId":"cc1184c3995c71a731357f9812aab988"
        }
    }