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

接口说明

接口名:ElementSmartVerify

服务地址:cloudauth.aliyuncs.com

请求方法:HTTPS POST和GET。

接口描述:纯服务端调用此接口,进行身份证照片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":"123456199012264321","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 123456199012264321 身份证号。
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无权限 需要为子账号授予AliyunYundunCloudAuthFullAccess的操作权限。
412 欠费中 智能核身或OSS存在欠费,请充值后再进行操作。
428 格式校验错误 传入的姓名、身份证号码长度必须符合国家标准且不得包含英文字母等特殊字符。
500 系统错误 系统内部错误,请提交工单进行反馈,由阿里云工程师协助排查。