调用DescribeSmartVerify查询身份证核验的结果。

接口说明

接口名:DescribeSmartVerify

服务地址:cloudauth.aliyuncs.com

请求方法:HTTPS POST和GET。

接口描述:当接入方的移动端收到回调之后,其服务端可以调用此接口,获取相应的认证状态和认证资料。

请求参数

名称 类型 是否必选 示例值 描述
SceneId Long 100000**** 认证场景ID。

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

CertifyId String 91707dc296d469ad38e4c5efa6a0**** 认证请求ID。

必须先调用身份证核验初始化提交认证请求,才能获得认证请求ID。

返回数据

名称 类型 是否必选 示例值 描述
RequestId String 130A2C10-B9EE-4D84-88E3-5384FF039795 请求ID。
Message String success 错误信息。
Code String 200 返回码,200表示接口响应成功。
ResultObject.Passed String T 认证是否通过,取值:
  • T:通过。
  • F:不通过。
说明 使用卡证核身识别模式时(调用身份证核验初始化Mode选择OCR),默认返回T
ResultObject.SubCode String 200 认证结果码。取值:
  • 200:认证通过。

    该结果将产生计费。

  • 201:(认证不通过)姓名和身份证不一致。

    该结果将产生计费。

    可能信息有误,建议用户确认后重新操作。

  • 202:(认证不通过)查询不到身份信息。

    该结果将产生计费。

    可能由于用户户口迁移、军人身份等特殊状态导致,建议预留人工审核入口,进行人工审核。

说明 使用卡证核身识别模式时(调用身份证核验初始化Mode选择OCR),默认返回200
ResultObject.MaterialInfo String {"ocrIdCardInfo":{//身份证字段信息},"ocrPictureInfo":{"ossBucketName":"cn-shanghai-aliyun-cloudauth-1260051251xxxxx","ossIdFaceObjectName":"smart/1260051251xxxxx/efcda7614d1f0a5f41dbc914e6647d50_OCR_ID_FACE_f30c.jpeg","ossIdNationalEmblemObjectName":"smart/1260051251xxxxx/efcda7614d1f0a5f41dbc914e6647d50_OCR_ID_NATIONAL_EMBLEM_afa9.jpeg","ossIdFaceUrl":"https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/smart/xxxxx/xxxxx.jpeg","ossIdNationalEmblemUrl":"https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/smart/xxxxx/xxxxx.jpeg","ossBankCardUrl":"https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/smart/xxxxx/xxxxx.jpeg"},"verifyInfo":{"realDocument":"T"},"ocrBankCardInfo":{"bankCardNo"} 认证主体的附件信息,包括识别结果信息、图片类材料等。使用JSON格式的字符串表示,结构描述如下:
  • ocrIdCardInfo:JSON字符串类型,证件信息。
  • ocrPictureInfo:JSON字符串类型,采集的认证照片信息。

    结构如下:

    • ossBucketName:String类型,身份证照片存储在您上海地域的OSS Bucket中,此处返回存储照片的Bucket名称。
    • ossIdFaceObjectName:String类型,身份证人像面的文件名。
    • ossIdNationalEmblemObjectName:String类型,身份证国徽面的文件名。
    • ossIdFaceUrl:String类型,身份证正面照片URL。

      当证件类型为身份证,模式选择OCR时,返回该参数。

    • ossIdNationalEmblemUrl:String类型,身份证国徽页照片URL。

      当证件类型为身份证,模式选择OCR时,返回该参数。

    • ossBankCardUrl:String类型,银行卡照片URL。

      当证件类型选择银行卡,模式选择OCR时,返回该参数。

    说明 返回的链接在15分钟内有效。
  • verifyInfo:JSON字符串类型,证件图片的防伪检测结果。

    结构如下:

    • realDocument:String类型,是否为真实证件。取值:
      • T:真实证件。
      • F:疑似伪造证件。
      说明 证件真实性检测依赖于采集图片的质量,存在一定概率的误识别和漏识别。目前支持检测翻拍证件、黑白复印证件。该字段仅作为业务参考,建议您结合其他维度信息综合判断。
  • ocrBankCardInfo:JSON字符串类型,银行卡号码。

    结构如下:

    • bankCardNo:String类型,银行卡号码信息。

示例

请参见身份证核验Java SDK调用示例
说明 如果您需要其他语言的SDK代码示例,您可以通过OpenAPI开发者门户在线调试工具调试API接口。运行成功后,OpenAPI开发者门户可以自动生成SDK代码示例。

错误码

Code Message 描述
200 success 接口响应成功。
400 参数不能为空 参数不能为空。
406 无效的certifyId 无效的CertifyId
410 未开通服务 未开通OSS产品或未完成OSS读写授权。具体操作,请参见授权增强版实人认证访问OSS空间
411 RAM无权限 需要给子账号授予AliyunYundunCloudAuthFullAccess的操作权限。具体操作,请参见授权RAM用户访问服务
424 身份认证记录不存在 CertifyId还没有对应的身份认证提交记录。
500 系统错误 系统内部错误。