本文介绍如何通过DescribeFaceVerify接口查询金融级NFC认证的认证结果。
接口说明
接口名：DescribeFaceVerify。
全局接入地址：cloudauth.aliyuncs.com（IPv4）或cloudauth-dualstack.aliyuncs.com（IPv6）
请求方法：POST和GET。
传输协议：HTTPS。
接口说明：当您收到回调通知之后，可以在服务端通过该接口获取相应的认证状态和认证资料。
QPS限量：API独享QPS限量，详情请参见服务端接口QPS限量说明。
请求参数
名称 | 类型 | 是否必选 | 描述 | 示例值 |
SceneId | Long | 是 | 认证场景ID。该ID在控制台创建认证场景后自动生成。关于如何创建认证场景，请参见添加认证场景。 | 1000000006 |
CertifyId | String | 是 | 实人认证唯一标识。该值需要调用InitFaceVerify-发起NFC认证请求获取。 | 91707dc296d469ad38e4c5efa6a0**** |
返回数据
名称 | 类型 | 是否必选 | 描述 | 示例值 |
RequestId | String | 是 | 请求ID。 | 130A2C10-B9EE-4D84-88E3-5384FF039795 |
Message | String | 否 | 请求信息的响应消息。 | success |
Code | String | 是 | 返回码。具体说明，请参见返回Code和Message。 | 200 |
ResultObject.Success | String | 是 | 认证是否成功，取值：
| T |
ResultObject.SubCode | String | 否 | 认证结果码。具体说明，请参见ResultObject.SubCode错误码说明。 | 200 |
ResultObject.MaterialInfo | String | 否 | 证件字段信息，JSON格式。 |
|
返回示例
ResultObject.MaterialInfo的JSON格式示例。
{
"passportInfo": {
// 出生日期
"birthDate":"87****",
// 国家或者地区代码
"countryCode":"C**",
// 英文名
"enName":" **** H**",
// 有效期止
"endTime":"29****",
// 护照编号
"idNum":"E*******2",
// 机读码
"machineReadCode":"POCHN***",
// 姓名
"name":"**",
// 国籍
"nationality":"C**",
// 其他号码
"otherIdNum":"",
// 其他名称
"otherName":"P*NG,HUI",
// 性别 女：F，男：M
"sex":"M",
// 签发时间
"signingTimes":""
}
"passportPictureFront":{
//oss 桶名称
"ossBucketName":"cn-shanghai-aliyun-cloudauth-xxxx",
//oss 护照高清头像文件名
"ossPassportFaceObjectName":"verify/xxxx/sha6ad4f83e872b411ec0a18aa5894cd_passport_picture.jpg",
//oss 护照高清头像URL
"ossPassportFaceUrl":"https://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/xxxx/sha6ad4f83e872b411ec0a18aa5894cd_passport_picture.jpgxxx",
//oss 护照合成证件图文件名
"ossPassportObjectName":"verify/xxxx/sha6ad4f83e872b411ec0a18aa5894cd_passport_image.jpg",
//oss 护照合成证件图URL
"ossPassportUrl":"https://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/xxxx/sha6ad4f83e872b411ec0a18aa5894cdxxx"
}
}ResultObject.SubCode错误码说明
具体说明，请参见ResultObject.SubCode错误码说明。
返回Code和Message说明
具体说明，请参见返回Code和Message。