调用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 | 认证是否通过,取值:
|
ResultObject.SubCode | String | 否 | 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格式的字符串表示,结构描述如下:
|
示例
请参见身份证核验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 | 系统错误 | 系统内部错误。 |