VerifyMaterial
传入姓名、身份证号、人像照、身份证正反面照片(可选)进行实人认证,并同步返回结果
服务地址:
华东1 金融云
输入参数
只看必填
IdCardBackImageUrl身份证国徽面图片的HTTP或HTTPS链接
FaceImageUrl人像正面照图片的HTTP或HTTPS链接
BizType使用实人认证服务的业务场景标识
BizId标识一次认证任务的唯一ID
Name姓名
IdCardNumber身份证号
IdCardFrontImageUrl身份证人像面图片的HTTP或HTTPS链接
UserId终端用户的ID
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

接入准备:接入该 API 时,请确保已经完成相应的准备工作,具体请参见服务端接入准备

请求方法:HTTPS POST 和 GET。

接口描述:接入方服务端提交认证材料到实人认证服务进行核实比对,结果同步返回。

适用范围:该接口仅适用于纯服务端接入的认证方案。

上传图片地址说明:

  • HTTP 或 HTTPS 地址:支持公网可访问的 HTTP 或 HTTPS 地址。例如,http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg
  • OSS 地址:接入方的图片如果是本地文件,阿里云也提供相应的上传 SDK,支持业务方将图片上传到实人认证服务指定的 OSS bucket 中,并获取相应的 OSS 地址后,作为接口的图片地址入参。如果您的业务需要使用上传 SDK,请提交工单联系我们获取。

图片限制说明:

  • 不支持本地图片的相对路径或绝对路径。
  • 单张图片大小请控制在 2 M 内,避免算法拉取超时。
  • 图片中人脸区域的大小至少 64*64 像素。
  • 单个请求的 Body 有 8 M 的大小限制,请计算好请求中所有图片和其他信息的大小,不要超限。

请求参数

字段名称字段详情
IdCardBackImageUrlstring

身份证国徽面图片的 HTTP 或 HTTPS 链接。

示例值:http://image-demo.img-cn-hangzhou.aliyuncs.com/example3.jpg
FaceImageUrlstring

人像正面照图片的 HTTP 或 HTTPS 链接。

示例值:http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg
BizTypestring

使用实人认证服务的业务场景标识。请先参见业务设置在控制台完成创建。

示例值:RPMinTest
BizIdstring

标识一次认证任务的唯一 ID,不超过 64 字符。针对一次认证任务,系统支持无限次发起提交,直到最终认证通过,该任务完结。展开详情

示例值:39ecf51e-2f81-4dc5-90ee-ff86125b****
Namestring

姓名。

示例值:张三
IdCardNumberstring

身份证号。

示例值:02343218901123****
IdCardFrontImageUrlstring

身份证人像面图片的 HTTP 或 HTTPS 链接。

示例值:http://image-demo.img-cn-hangzhou.aliyuncs.com/example2.jpg
UserIdstring

终端用户的 ID,例如终端用户的账号 ID。

示例值:54sdj

返回参数

字段名称字段详情
AuthorityComparisionScorenumber<float>

认证过程中所提交的人脸照片和权威数据的比对分,取值范围:0~100展开详情

示例值:97
VerifyStatusinteger<int32>

认证状态。取值:展开详情

示例值:1
RequestIdstring

请求 ID。

示例值:04F0F334-1335-436C-A1D7-6C044FE73368
VerifyTokenstring

该次认证的 Token,用来串联认证请求中的各个接口,在 30 分钟内有效。

示例值:c302c0797679457685410ee51a5ba375
IdCardFaceComparisonScorenumber<float>

认证过程中所提交的人脸照片和身份证人像面图片上人脸的比对分,取值范围:0~100展开详情

示例值:97
Materialobject

认证材料。

返回说明

认证状态说明

VerifyStatus原因说明
1认证通过。
2认证不通过,原因:实名校验不通过。
3认证不通过,可能原因:身份证照片模糊、光线问题造成字体无法识别、身份证照片信息与需认证的身份证姓名不一致、提交的照片为非身份证照片。
4认证不通过,可能原因:身份证照片模糊、光线问题造成字体无法识别、身份证照片信息与需认证的身份证号码不一致、提交的照片为非身份证照片。
5认证不通过,可能原因:身份证照片上的有效期已过期(或即将过期)。
6认证不通过,可能原因:人脸与身份证头像不一致。
7认证不通过,可能原因:人脸与公安网照片不一致。
8认证不通过,可能原因:提交的身份证照片非身份证原照片、未提交有效身份证照片。
9认证不通过,可能原因:非账户本人操作。
11认证不通过,可能原因:公安网照片缺失、公安网照片格式错误、公安网照片未找到人脸。
12认证不通过,可能原因:公安网系统异常,无法进行照片比对等可能。
变更历史
暂无变更历史