人脸核身多张照片查询接口:获取人脸核身结果多张照片的接口。
一、准备步骤
·前置条件:请合作方确保 SIGN ticket 已经正常获取,获取方式见 SIGN ticket 获取。
·合作方为人脸验证服务生成签名,需要具有以下参数:
| 参数 | 说明 | 来源 |
| webankAppId | 业务流程唯一标识 | 参考 获取 WBappid 指引在人脸核身控制台内申请。 |
| orderNo | 订单号,字母/数字组成的字符串,是你需要查询结果的人脸核身订单号 | 合作方自行分配。 |
| version | 默认值:1.0.0 | – |
| api ticket | 合作伙伴服务端缓存的 tikcet,注意是 SIGN 类型 | 获取方式见 SIGN ticket 获取。 |
| nonce | 32 位随机字符串,字母和数字 | 合作方自行生成。 |
二、基本步骤
1. 生成一个 32 位的随机字符串nonceStr(其为字母和数字,登录时也要用到)。
2. 将 app_id、order_no、version 连同 ticket、nonceStr 共五个参数的值进行字典序排序。
3. 将排序后的所有参数字符串拼接成一个字符串。
4. 将排序后的字符串进行 SHA1编码,编码后的 40 位字符串作为签名(sign)。
注意:签名算法可参考 签名算法说明。
三、请求
请求URL: https://kyc1.qcloud.com/api/v2/base/queryphotoinfo?orderNo=xxx
注意:为方便查询耗时,该请求 url 后面请拼接 orderNo 订单号参数。
请求方法:POST
HTTP 请求 header:
| 参数名 | 必选 | 类型 | 说明 |
| Content-Type | 是 | string | application/json |
请求参数:
| 参数 | 说明 | 类型 | 长度(字节) | 是否必填 |
| webankAppId | 腾讯服务分配的AppId | 字符串 | 腾讯服务分配 | 是 |
| version | 版本号,默认值:1.0.0 | 字符串 | 20 | 是 |
| nonce | 随机数 | 字符串 | 32 | 是 |
| orderNo | 订单号,字母/数字组成的字符串,是你需要查询结果的人脸核身订单号 | 字符串 | 32 | 是 |
| sign | 签名值,使用本页第一步生成的签名 | 字符串 | 40 | 是 |
四、响应示例
{ "code": 0, "msg":"请求成功", "bizSeqNo":"业务流水号", "result": { "orderNo": "AAAAAA001", "occurredTime": "20180907142653", "photoList":["第一个base64photo字符串", "第二个base64photo字符串", "第三个base64photo字符串"] } }
五、响应参数
| 参数名 | 类型 | 说明 |
| code | int | 0:成功,非0失败 |
| msg | string | 请求结果描述 |
| bizSeqNo | string | 请求业务流水号 |
| orderNo | string | 订单编号 |
| occurredTime | string | 刷脸时间(yyyyMMddHHmmss) |
| photoList | List | base64图像列表(返回1-3张照片) |