调用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 | 卡证核身的模式。取值：
|
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链接。 CertUrl和CertFileObject二选一。 |
CertFileObject | InputStream | 否 | 无 | 本地证件文件。 CertUrl和CertFileObject二选一。 |
CertNationalEmblemUrl | String | 否 | https://www.aliyun.com/cert.jpeg | 身份证国徽面证件地址，公网可访问的HTTP、HTTPS链接。 |
返回数据
名称 | 类型 | 是否必选 | 示例值 | 描述 |
RequestId | String | 是 | 130A2C10-B9EE-4D84-88E3-5384FF039795 | 请求ID。 |
Message | String | 否 | success | 返回信息。 |
Code | String | 是 | 200 | 返回码。取值：
|
ResultObject.Passed | String | 否 | T | 认证是否通过，取值：
说明 如果接口异常或接口是未认证状态，则不返回该参数。 |
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补充说明。 |
名称 | 类型 | 示例值 | 描述 |
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 | 有效期限结束时间。 |
错误码 | 认证描述文案 | 是否计费 | 说明 |
200 | 认证通过。 | 是 | 认证通过。 |
201 | 实名校验不通过。 | 是 | 认证不通过，可能原因：用户的身份信息不匹配、信息有误或查询不到身份信息。 |
202 | 查询不到身份信息。 | 是 | 认证不通过，可能用户户口迁移等特殊状态导致，建议预留人工审核入口，用于人工审核。 |
错误码
Code | Message | 描述 |
200 | success | 接口响应成功。 |
400 | 参数不能为空 | 参数不能为空。 |
401 | 参数非法 | 传入的字段不符合取值范围或长度不符合要求。 |
410 | 未开通服务 | 未开通OSS产品或未完成OSS读写授权，请登录增强版实人认证控制台完成授权。 |
411 | RAM无权限 | 需要为RAM用户授予AliyunYundunCloudAuthFullAccess的操作权限。 |
412 | 欠费中 | 增强版实人认证或OSS存在欠费，请充值后再进行操作。 |
428 | 格式校验错误 | 传入的姓名、身份证号码长度必须符合国家标准且不得包含英文字母等特殊字符。 |
440 | OCR识别失败 | OCR识别失败。请检查输入图片内容，保证照片清晰、曝光正常，完整无遮挡，角度无太大偏差。 |
500 | 系统错误 | 系统内部错误，请通过智能在线联系阿里云工程师协助排查。 |