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

这篇说说腾讯云人脸核身多张照片查询接口,包括合作方后台生成签名的准备步骤与基本步骤,以及核身结果查询接口的请求参数、响应参数和示例。 签名生成:合作方需准备webankAppId、orderNo等参数,将五个参数排序后拼接并SHA1编码生成签名。 接口请求:通过POST请求URL 响应结果:返回code、msg、bizSeqNo及包含orderNo、occurredTime和photoList(base64图像列表。

相关产品
人脸核身 产品页,含版本规格、价格与购买入口。

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

一、准备步骤

·前置条件:请合作方确保 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张照片)
赞 (0)
上一篇 4天前
下一篇 4天前