本文介紹如何通過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。