SAAS云部署
PAAS私有化部署
文档中心
支付宝H5人脸识别API
1. 接口描述
在移动端的H5页面中调用，通过支付宝（APP）完成实人认证
2. 使用场景
Web系统：登录指定的网页，办理业务，在需要用户实人认证的环节中，显示二维码（跳转至H5引导页，完成转场），用户通过移动应用扫码后，开启支付宝APP完成实人认证。
移动应用：登录移动端办理业务，在需要用户实人认证的环节中，开启支付宝APP完成实人认证。
3. 接口说明
3.1. 获取人脸识别链接
获取调用支付宝（APP）人脸识别的url
3.1.1. 接口协议
HTTP POST
3.1.2. 接口方法
https://api.juncyun.com/api/safFace/faceCertification
3.1.3. 报头定义
|
编码 |
列表 |
内容 |
备注 |
|
1） |
Accept |
application/json |
|
|
2） |
Content-Type |
application/json;charset=utf-8 |
|
3.1.4. 请求参数
3.1.4.1. 请求参数列表
|
编码 |
列表 |
内容 |
备注 |
|
1） |
accessKey |
API调用账号（必填，从云极平台获取） |
|
|
2） |
accessSecret |
API调用密钥（必填，从云极平台获取） |
|
|
3） |
idNo |
身份证号码（必填） |
|
|
4） |
name |
姓名（必填） |
|
|
5） |
callbackUrl |
认证成功后重定向地址（必填） |
|
|
6) |
returnUrl |
主动回调用户参数（选填） |
必须是POST请求，如果请求失败会进入延时队列 总共请求11次 分别间隔为 1s 5s 10s 30s 1m 2m 3m 4m 5m 6m 7m 8m 9m 10m //1成功2失败 // 发起请求时返回的certifyId "certifyId":"xx222111" |
3.1.4.2. 请求参数示例
{
"accessKey":"87d0373b**********",
"accessSecret":"b20d7c5e1c********************",
"idNo":"341225****",
"name":"李明",
"callbackUrl":"www.*.com",
"returnUrl": "www.*.com"
}
3.1.5. 响应参数
3.1.5.1. 响应参数列表
|
编码 |
列表 |
内容 |
备注 |
|
1） |
code |
状态码200则为成功 |
|
|
2） |
msg |
状态说明 |
|
|
3） |
success |
处理是否成功:取值范围 true，false |
|
|
4） |
data |
业务数据 如果失败则为空 |
|
|
5） |
certifyId |
流水号id用于获取人脸识别结果的表示 |
|
|
6） |
certifyUrl |
获取个人刷脸实名认证长链接。有效时长3天 |
|
3.1.5.2. 响应参数示例
{
"code": 200,
"msg": "成功",
"success": true,
"data": {
"certifyUrl": "https://picker.antcloudauth*******",
"certifyId": "a*****"
}
}
3.1.5.3. 结果码说明
|
结果码 |
描述 |
|
200 |
成功 |
|
401 |
初始化时传入的参数不正确，请检查各个传参是否符合预期。 |
|
403 |
主账号*******，无权调用fin_face_verify服务，或服务已到期、已到最大流量、未购买服务", "主账号*******，无权调用fin_face_verify服务，或服务已到期、已到最大流量、未购买服务 |
|
402，404 |
认证场景配置不存在，请先在控制台上创建认证场景 |
|
406 |
无效的certifyId |
|
407 |
认证已失效 |
|
408 |
开放认证单据已失效 |
|
500，501，503 |
系统错误 |
|
502 |
系统繁忙 |
|
60021 |
余额不足，请充值后重试！ |
|
10000 |
内部系统出错，请联系厂商 |
3.2. 获取人脸识别结果
3.2.1. 接口协议
HTTP POST
3.2.2. 接口方法
https://api.juncyun.com/api/safFace/faceResult
3.2.3. 报头定义
|
编码 |
列表 |
内容 |
备注 |
|
1） |
Accept |
application/json |
|
|
2） |
Content-Type |
application/json;charset=utf-8 |
|
3.2.4. 请求参数
3.2.4.1. 请求参数列表
|
编码 |
列表 |
内容 |
备注 |
|
1） |
accessKey |
API调用账号（必填） |
|
|
2） |
accessSecret |
API调用密钥（必填） |
|
|
3） |
certifyId |
流水号,请求人脸识别接口返回消息体的certifyId |
|
3.2.4.2. 请求参数示例
{
"accessKey": "87d03*****",
"accessSecret": "b20d7*****",
"certifyId": "a123*****"
}
3.2.5. 响应参数
3.2.5.1. 响应参数列表
|
编码 |
列表 |
内容 |
备注 |
|
1） |
code |
状态码 |
|
|
2） |
msg |
状态说明 |
|
|
3） |
success |
处理是否成功:取值范围 true，false |
|
|
4） |
data |
业务数据 如果失败则为空 |
|
|
5） |
deduction |
是否计费，取值范围：0,1 （0不计费，1计费） |
|
|
6） |
passed |
是否成功，取值范围：T,P（T验证通过，P验证不通过） |
|
3.2.5.2. 响应参数示例
{
"code": 200,
"msg": "操作成功",
"success": true,
"data": {
"deduction": 1,
"passed": "T"
}
}
3.2.5.3. 结果码说明
|
结果码 |
描述 |
|
200 |
处理成功。 |
|
5001 |
请求参数校验异常，请检查参数是否正确 |
|
60022 |
暂无回调信息，请稍候重试 |
支付宝H5人脸识别API
1. 接口描述
在移动端的H5页面中调用，通过支付宝（APP）完成实人认证
2. 使用场景
Web系统：登录指定的网页，办理业务，在需要用户实人认证的环节中，显示二维码（跳转至H5引导页，完成转场），用户通过移动应用扫码后，开启支付宝APP完成实人认证。
移动应用：登录移动端办理业务，在需要用户实人认证的环节中，开启支付宝APP完成实人认证。
3. 接口说明
3.1. 获取人脸识别链接
获取调用支付宝（APP）人脸识别的url
3.1.1. 接口协议
HTTP POST
3.1.2. 接口方法
https://api.juncyun.com/api/safFace/faceCertification
3.1.3. 报头定义
|
编码 |
列表 |
内容 |
备注 |
|
1） |
Accept |
application/json |
|
|
2） |
Content-Type |
application/json;charset=utf-8 |
|
3.1.4. 请求参数
3.1.4.1. 请求参数列表
|
编码 |
列表 |
内容 |
备注 |
|
1） |
accessKey |
API调用账号（必填，从云极平台获取） |
|
|
2） |
accessSecret |
API调用密钥（必填，从云极平台获取） |
|
|
3） |
idNo |
身份证号码（必填） |
|
|
4） |
name |
姓名（必填） |
|
|
5） |
callbackUrl |
认证成功后重定向地址（必填） |
|
|
6) |
returnUrl |
主动回调用户参数（选填） |
必须是POST请求，如果请求失败会进入延时队列 总共请求11次 分别间隔为 1s 5s 10s 30s 1m 2m 3m 4m 5m 6m 7m 8m 9m 10m //1成功2失败 // 发起请求时返回的certifyId "certifyId":"xx222111" |
3.1.4.2. 请求参数示例
{
"accessKey":"87d0373b**********",
"accessSecret":"b20d7c5e1c********************",
"idNo":"341225****",
"name":"李明",
"callbackUrl":"www.*.com",
"returnUrl": "www.*.com"
}
3.1.5. 响应参数
3.1.5.1. 响应参数列表
|
编码 |
列表 |
内容 |
备注 |
|
1） |
code |
状态码200则为成功 |
|
|
2） |
msg |
状态说明 |
|
|
3） |
success |
处理是否成功:取值范围 true，false |
|
|
4） |
data |
业务数据 如果失败则为空 |
|
|
5） |
certifyId |
流水号id用于获取人脸识别结果的表示 |
|
|
6） |
certifyUrl |
获取个人刷脸实名认证长链接。有效时长3天 |
|
3.1.5.2. 响应参数示例
{
"code": 200,
"msg": "成功",
"success": true,
"data": {
"certifyUrl": "https://picker.antcloudauth*******",
"certifyId": "a*****"
}
}
3.1.5.3. 结果码说明
|
结果码 |
描述 |
|
200 |
成功 |
|
401 |
初始化时传入的参数不正确，请检查各个传参是否符合预期。 |
|
403 |
主账号*******，无权调用fin_face_verify服务，或服务已到期、已到最大流量、未购买服务", "主账号*******，无权调用fin_face_verify服务，或服务已到期、已到最大流量、未购买服务 |
|
402，404 |
认证场景配置不存在，请先在控制台上创建认证场景 |
|
406 |
无效的certifyId |
|
407 |
认证已失效 |
|
408 |
开放认证单据已失效 |
|
500，501，503 |
系统错误 |
|
502 |
系统繁忙 |
|
60021 |
余额不足，请充值后重试！ |
|
10000 |
内部系统出错，请联系厂商 |
3.2. 获取人脸识别结果
3.2.1. 接口协议
HTTP POST
3.2.2. 接口方法
https://api.juncyun.com/api/safFace/faceResult
3.2.3. 报头定义
|
编码 |
列表 |
内容 |
备注 |
|
1） |
Accept |
application/json |
|
|
2） |
Content-Type |
application/json;charset=utf-8 |
|
3.2.4. 请求参数
3.2.4.1. 请求参数列表
|
编码 |
列表 |
内容 |
备注 |
|
1） |
accessKey |
API调用账号（必填） |
|
|
2） |
accessSecret |
API调用密钥（必填） |
|
|
3） |
certifyId |
流水号,请求人脸识别接口返回消息体的certifyId |
|
3.2.4.2. 请求参数示例
{
"accessKey": "87d03*****",
"accessSecret": "b20d7*****",
"certifyId": "a123*****"
}
3.2.5. 响应参数
3.2.5.1. 响应参数列表
|
编码 |
列表 |
内容 |
备注 |
|
1） |
code |
状态码 |
|
|
2） |
msg |
状态说明 |
|
|
3） |
success |
处理是否成功:取值范围 true，false |
|
|
4） |
data |
业务数据 如果失败则为空 |
|
|
5） |
deduction |
是否计费，取值范围：0,1 （0不计费，1计费） |
|
|
6） |
passed |
是否成功，取值范围：T,P（T验证通过，P验证不通过） |
|
3.2.5.2. 响应参数示例
{
"code": 200,
"msg": "操作成功",
"success": true,
"data": {
"deduction": 1,
"passed": "T"
}
}
3.2.5.3. 结果码说明
|
结果码 |
描述 |
|
200 |
处理成功。 |
|
5001 |
请求参数校验异常，请检查参数是否正确 |
|
60022 |
暂无回调信息，请稍候重试 |
一对一服务，更有优惠惊喜
