人脸认证多张照片查询接口

最近更新时间:2019-07-30 16:32:09

人脸认证多张照片查询接口:获取人脸认证结果多张照片的接口。

合作方后台生成签名

准备步骤

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

基本步骤

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

    注意:

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

人脸认证多张照片查询接口

请求

请求URL:https://idasc.webank.com/api/v2/base/queryphotoinfo
请求方法:POST
HTTP 请求 header:

参数名 是否必选 类型 说明
Content-Type String application/json

请求参数:

参数 说明 类型 长度(字节) 是否必填
webankAppId 腾讯服务分配的 AppID String 腾讯服务分配
version 版本号,默认值:1.0.0 String 20
nonce 随机数 String 32
orderNo 订单号,合作方订单的唯一标识 String 32
sign 签名值,使用本页第一步生成的签名 String 40

响应

返回参数说明:

参数名 类型 说明
code int 0:成功
非0:失败
msg String 请求结果描述
bizSeqNo String 请求业务流水号
orderNo String 订单编号
occurredTime String 刷脸时间(yyyyMMddHHmmss)
photoList List Base64 图像列表(返回1 - 3张照片)

返回示例:

{
"code": 0,
"msg": "请求成功",
"bizSeqNo": "业务流水号",
"result": {
"orderNo": "AAAAAA001",
"occurredTime": "20180907142653",
"photoList": ["第一个base64photo字符串", "第二个base64photo字符串", "第三个base64photo字符串"]
}
}