AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 实人认证 金融级实人认证 开发参考 金融级NFC认证方案 服务端API接口 DescribeFaceVerify－查询NFC认证结果

DescribeFaceVerify－查询NFC认证结果

更新时间：
产品详情
我的收藏

本文介绍如何通过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

Code

String

是

返回Code。

200

Message

String

否

返回Code的描述信息。

success

ResultObject.Success

String

是

认证是否成功，取值：

  • T：成功

  • F：失败

T

ResultObject.SubCode

String

否

认证结果码。具体说明，请参见ResultObject.SubCode错误码说明。

200

ResultObject.MaterialInfo

String

否

人脸认证主体附件信息：

  • 证件要素信息

  • 证件人脸照片

{
  "passportInfo": {
    "birthDate": "87****",
    "countryCode": "C**",
    "enName": " **** H**",
    "endTime": "29****",
    "idNum": "E*******2",
    "machineReadCode": "POCHN***",
    "name": "**",
    "nationality": "C**",
    "otherIdNum": "",
    "otherName": "P*NG,HUI",
    "sex": "M",
    "signingTimes": ""
  },
  "passportPictureFront": {
    "ossBucketName": "cn-shanghai-aliyun-cloudauth-xxxx",
    "ossPassportFaceObjectName": "verify/xxxx/sha6ad4f83e872b411ec0a18aa5894cd_passport_picture.jpg",
    "ossPassportFaceUrl": "https://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/xxxx/sha6ad4f83e872b411ec0a18aa5894cd_passport_picture.jpgxxx",
    "ossPassportObjectName": "verify/xxxx/sha6ad4f83e872b411ec0a18aa5894cd_passport_image.jpg",
    "ossPassportUrl": "https://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/xxxx/sha6ad4f83e872b411ec0a18aa5894cdxxx"
  }
}

上一篇：InitFaceVerify-发起NFC认证请求下一篇：SDK调用示例