文档

实名二要素

更新时间:

调用ElementSmartVerify接口发起卡证核身请求,进行身份证照片OCR、姓名和身份证二要素验证。

传入图片格式要求

  • 图片大小:图片大小建议不超过2 MB。图片过大可能会影响接口响应速度,甚至可能导致读取图片超时失败。

  • 图片格式:PNG、JPG、JPEG。

  • 图片分辨率:图片长宽需要大于64像素且小于8192像素。

  • 图片质量要求:图片模糊、内容遮挡、光线或图片角度异常都可能会对识别结果产生影响;在识别身份证人像面时,需要确保人脸呈现正向。

接口说明

接口名:ElementSmartVerify

服务地址:cloudauth.aliyuncs.com

请求方法:POST和GET。

传输协议:HTTPS。

接口描述:纯服务端调用此接口,进行身份证照片OCR、姓名和身份证二要素验证。

请求参数

名称

类型

是否必选

示例值

描述

SceneId

Long

100000xxxx

认证场景ID。

您必须先在增强版实人认证控制台创建认证场景,才能获得认证场景ID。更多信息,请参见添加认证场景

OuterOrderNo

String

e0c34a77f5ac40a5aa5e6ed20c35xxxx

商户服务端自定义的业务请求唯一标识,用于后续定位排查问题使用,由32位字母、数字组合而成。

Mode

String

OCR_ID

卡证核身的模式。取值:

  • OCR_ID:身份证照片识别模式。

  • OCR_VERIFY_ID_NAME:身份证照片识别且认证模式。

  • VERIFY_ID_NAME:认证模式。

CertType

String

IDENTITY_CARD

证件类型。唯一取值:IDENTITY_CARD,表示身份证。

CertName

String

张三

用户的真实姓名。

Mode取值为VERIFY_ID_NAME时,CertName为必选字段。

CertNo

String

330103xxxxxxxxxxxx

用户的证件号码。

Mode取值为VERIFY_ID_NAME时,CertNo为必选字段。

CertUrl

String

https://www.aliyun.com/cert.jpeg

证件地址,公网可访问的HTTP、HTTPS链接。

CertUrlCertFileObject二选一。

CertFileObject

InputStream

本地证件文件。

CertUrlCertFileObject二选一。

CertNationalEmblemUrl

String

https://www.aliyun.com/cert.jpeg

身份证国徽面证件地址,公网可访问的HTTP、HTTPS链接。

返回数据

名称

类型

是否必选

示例值

描述

RequestId

String

130A2C10-B9EE-4D84-88E3-5384FF039795

请求ID。

Message

String

success

返回信息。

Code

String

200

返回码。取值:

  • 200:成功。

  • 其他错误码,请参见错误码

ResultObject.Passed

String

T

认证是否通过,取值:

  • T:通过。

  • F:不通过。

说明

如果接口异常或接口是未认证状态,则不返回该参数。

ResultObject.SubCode

String

200

认证结果码,请参见ResultObject.SubCode补充说明。

ResultObject.CertifyId

String

08573be80f944d95ac812e019e3655a8

认证请求ID,增强版实人认证服务认证请求的唯一标识。

ResultObject.MaterialInfo.ocrIdCardInfo

String

{"ocrIdCardInfo":{"address":"浙江省杭州市余杭区文一西路969号","birthDate":"19901226","certName":"张三","certNo":"1234561990122*****","nationality":"汉","authority":"xxx公安局","startDate":"20201130","endDate":"20301130"}}

认证主体的卡证信息识别结果,请参见ResultObject.MaterialInfo.ocrIdCardInfo补充说明

表 1. ResultObject.MaterialInfo.ocrIdCardInfo补充说明

名称

类型

示例值

描述

address

String

xx省xx市xx区xx969号

身份证上的住址。

birthDate

String

19901xxx

身份证上的出生日期。

certName

String

张三

身份证上的姓名。

certNo

String

1234561990122*****

身份证号。

nationality

String

民族。

authority

String

xxx公安局

签发机关。

startDate

String

20201130

有效期限开始时间。

endDate

String

20301130

有效期限结束时间。

表 2. ResultObject.SubCode补充说明

错误码

认证描述文案

是否计费

说明

200

认证通过。

认证通过。

201

实名校验不通过。

认证不通过,可能原因:用户的身份信息不匹配、信息有误或查询不到身份信息。

202

查询不到身份信息。

认证不通过,可能用户户口迁移等特殊状态导致,建议预留人工审核入口,用于人工审核。

错误码

Code

Message

描述

200

success

接口响应成功。

400

参数不能为空

参数不能为空。

401

参数非法

传入的字段不符合取值范围或长度不符合要求。

410

未开通服务

未开通OSS产品或未完成OSS读写授权,请登录增强版实人认证控制台完成授权。

411

RAM无权限

需要为RAM用户授予AliyunYundunCloudAuthFullAccess的操作权限。

412

欠费中

增强版实人认证或OSS存在欠费,请充值后再进行操作。

428

格式校验错误

传入的姓名、身份证号码长度必须符合国家标准且不得包含英文字母等特殊字符。

440

OCR识别失败

OCR识别失败。请检查输入图片内容,保证照片清晰、曝光正常,完整无遮挡,角度无太大偏差。

500

系统错误

系统内部错误,请通过智能在线联系阿里云工程师协助排查。

  • 本页导读
文档反馈