本文介绍如何通过调用DescribeCardVerify接口查询认证结果。
接口信息
在使用本接口前,请确保已完整阅读接入流程,并开通服务。
接口名:DescribeCardVerify
全局接入地址:cloudauth.aliyuncs.com(IPv4)或cloudauth-dualstack.aliyuncs.com(IPv6)
请求方法:POST和GET
传输协议:HTTPS
接口说明:当您收到回调通知之后,可以在服务端通过该接口获取相应的认证状态和认证资料。
QPS限量:API独享QPS限量,详情请参见信息核验接口QPS限量说明。
请求参数
名称 | 类型 | 是否必选 | 描述 | 示例值 |
CertifyId | String | 是 | 认证请求ID。 此参数调用 InitCardVerify 接口返回。 | 91707dc296d469ad38e4c5ef******** |
响应结果
名称 | 类型 | 描述 | 示例值 | |
RequestId | String | 请求ID。 | 130A2C10-B9EE-4D84-88E3-5384FF03**** | |
Message | String | 接口调用返回信息。 | success | |
Code | String | 返回码:200表示成功,其他均为失败。 重要
| 200 | |
ResultObject | BizCode | String | 身份核验结果:
| 1 |
CardInfo | String | 提交核验的身份证信息。 详细说明请查看ResultObject.CardInfo字段说明。 |
| |
PictureInfo | String | 经过客户端编辑后的卡证信息,使用JSON格式的字符串返回。 |
| |
OcrCardInfo | Sting | OCR读取的身份证信息。 | 详细说明请查看ResultObject.CardInfo字段说明。 |
ResultObject.CardInfo
名称 | 类型 | 描述 | 示例值 |
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 |
SDK调用示例
集成前请确保您已完整阅读接入流程,开通了服务并获取AccessKey且正确配置环境变量。