找不到 API ? 点击 反馈吧
- 金融级实人认证
- 增强版实人认证
- 信息核验
- 车辆信息识别VehicleQuery
- 车辆要素核验VehicleMetaVerify
- 车辆投保日期查询VehicleInsureQuery
- 车辆要素核验增强版VehicleMetaVerifyV2
- 车五项信息识别Vehicle5ItemQuery
- 人脸Deepfake检测服务DeepfakeDetect
- 凭证核验CredentialVerify
- 银行卡二,三,四要素核验BankMetaVerify
- 手机号在网时长MobileOnlineTime
- 号码批量检测MobileDetect
- 手机号在网状态MobileOnlineStatus
- 手机号三要素简版接口Mobile3MetaSimpleVerify
- 手机号三要素简版——标准版Mobile3MetaSimpleStandardVerify
- 手机号三要素详版——标准版Mobile3MetaDetailStandardVerify
- 身份二要素核验接口Id2MetaVerify
- 二要素有效期核验Id2MetaPeriodVerify
- 身份二要素标准版核验接口Id2MetaStandardVerify
- 手机号三要素详版接口Mobile3MetaDetailVerify
- 实人认证(已停止售卖,文档停止更新)
- 其他
- 其它
VerifyMaterial
传入姓名、身份证号、人像照、身份证正反面照片(可选)进行实人认证,并同步返回结果
服务地址:
华东1 金融云
参数配置
高级配置
输入参数
只看必填
注意事项
IdCardBackImageUrl身份证国徽面图片的HTTP或HTTPS链接
FaceImageUrl人像正面照图片的HTTP或HTTPS链接
BizType使用实人认证服务的业务场景标识
BizId标识一次认证任务的唯一ID
Name姓名
IdCardNumber身份证号
IdCardFrontImageUrl身份证人像面图片的HTTP或HTTPS链接
UserId终端用户的ID
文档
调用结果
SDK 示例
CLI示例
相关示例
调用历史
错误码
流控
插件下载了解更多
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
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 | 认证不通过,可能原因:公安网系统异常,无法进行照片比对等可能。 |
变更历史
暂无变更历史