人脸认证多张照片查询接口:获取人脸认证结果多张照片的接口。
合作方后台生成签名
准备步骤
前置条件:请合作方确保 SIGN ticket 已经正常获取,获取方式见 SIGN ticket 获取 。
合作方为人脸验证服务生成签名,需要具有以下参数:
参数 | 说明 | 来源 |
appId | 业务流程唯一标识 | |
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 | 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 无意义,合作伙伴可忽略,无需处理。