DescribeFaceVerify-查询NFC认证结果

更新时间:2024-10-25 06:32:34

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

  • F:失败。

T

ResultObject.SubCode

String

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

200

ResultObject.MaterialInfo

String

证件字段信息,JSON格式。

{

passportInfo: {

......

}

}

返回示例

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

  • 本页导读
  • 接口说明
  • 请求参数
  • 返回数据
  • 返回示例
  • ResultObject.SubCode错误码说明
  • ​返回Code和Message说明