文档中心 人脸核身 接入文档 PC 端 H5 接入 合作方后台上送身份信息

合作方后台上送身份信息

最近更新时间:2019-09-24 14:35:54

生成签名

准备步骤

  • 前置条件:请合作方确保 SIGN ticket 已经正常获取,获取方式见 SIGN ticket 获取
  • 合作方为人脸验证服务生成签名,需要具有下表中的参数:
  • 参与签名的数据需要和使用该签名的接口中的请求参数保持一致。
参数 说明 来源
wbappid 请添加小助手微信 faceid001,进行线下对接获取 腾讯云线下对接分配
orderNo 订单号,本次人脸验证合作伙伴上送的订单号,唯一标识 合作方自行分配
name 姓名 -
idNo 证件号码 -
userId 用户 ID ,用户的唯一标识(不要带有特殊字符) 合作方自行分配
version 1.0.0 -
api ticket 合作伙伴服务端缓存的 tikcet,注意是 SIGN 类型 获取方式见 SIGN ticket 获取

基本步骤

  1. 将 wbappid、orderNo、name、idNo、userId、version、api ticket(SIGN 类型)共7个参数的值进行字典序排序。
  2. 将排序后的所有参数字符串拼接成一个字符串。
  3. 将排序后的字符串进行 SHA1 编码,编码后的40位字符串作为签名(sign)。
注意:

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

参考示例

请求参数:

参数名 参数值
wbappid appId001
orderNo orderNo19959248596551
name testName
idNo 4300000000000
userId userID19959248596551
version 1.0.0
ticket duSz9ptwyW1Xn7r6gYItxz3feMdJ8Na5x7JZuoxurE7RcI5TdwCE4KT2eEeNNDoe

字典排序后的参数为:

[1.0.0, 4300000000000, appId001, duSz9ptwyW1Xn7r6gYItxz3feMdJ8Na5x7JZuoxurE7RcI5TdwCE4KT2eEeNNDoe, orderNo19959248596551, testName, userID19959248596551]

拼接后的字符串为:

1.0.04300000000000appId001duSz9ptwyW1Xn7r6gYItxz3feMdJ8Na5x7JZuoxurE7RcI5TdwCE4KT2eEeNNDoeorderNo19959248596551testNameuserID19959248596551

计算 SHA1 得到签名:
该字符串就是最终生成的签名(40位),不区分大小写。

EE57F7C1EDDE7B6BB0DFB54CD902836B8EB0575B

合作方后台上送身份信息

请求

请求 URL: https://idasc.webank.com/api/server/h5/geth5faceid
请求方法:POST
报文格式Content-Type: application/json
请求参数

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

响应

响应示例:

{
"code": 0,
"msg": "成功",
"result": {
"bizSeqNo":"业务流水号",
"orderNo":"合作方订单号",
"h5faceId":"cc1184c3995c71a731357f9812aab988"
}
}