登录

文档中心

文档目录

支付宝H5人脸识别API

最近更新时间: 2023-12-06 17:59:40

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

认证成功后重定向地址(必填)

 

 

3.1.4.2. 请求参数示例

{

  "accessKey":"87d0373b**********",

  "accessSecret":"b20d7c5e1c********************",

  "idNo":"341225****",

  "name":"李明",

  "callbackUrl":"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

最近更新时间: 2023-12-06 17:59:40

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

认证成功后重定向地址(必填)

 

 

3.1.4.2. 请求参数示例

{

  "accessKey":"87d0373b**********",

  "accessSecret":"b20d7c5e1c********************",

  "idNo":"341225****",

  "name":"李明",

  "callbackUrl":"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

暂无回调信息,请稍候重试

 

 

加微咨询

一对一服务,更有优惠惊喜