核身结果-多照片查询接口

最近更新时间:2024-06-17 17:09:41

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

合作方后台生成签名

准备步骤

前置条件:请合作方确保 SIGN ticket 已经正常获取,获取方式见 SIGN ticket 获取
合作方为人脸验证服务生成签名,需要具有以下参数:
参数
说明
来源
appId
业务流程唯一标识
参考 获取 WBappid 指引在人脸核身控制台内申请
orderNo
订单号,字母/数字组成的字符串,本次人脸验证合作伙伴上送的订单号,唯一标识
合作方自行分配,不要带有特殊字符
version
默认值:1.0.0
-
ticket
合作伙伴服务端缓存的 ticket,注意是 SIGN 类型
获取方式见 SIGN ticket 获取
nonce
32位随机字符串,字母和数字
合作方自行生成,不要带有特殊字符

基本步骤

1. 生成一个32位的随机字符串 nonce(其为字母和数字,登录时也要用到)。
2. 将 appId、orderNo、version 连同 ticket、nonce 共5个参数的值进行字典序排序。
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
请求参数:
参数
说明
类型
长度(字节)
是否必填
appId
业务流程唯一标识,即 WBappid,可参考 获取 WBappid 指引在人脸核身控制台内申请
String
8
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张照片),若照片不存在,则返回 null
返回示例:
{
"code": 0,
"msg": "请求成功",
"bizSeqNo": "业务流水号",
"result": {
"orderNo": "AAAAAA001",
"occurredTime": "20180907142653",
"photoList": ["第一个base64photo字符串", "第二个base64photo字符串", "第三个base64photo字符串"]
}
}
说明
success:false 无意义,合作伙伴可忽略,无需处理。