接口說明
接口名：DescribeFaceVerify。
全局接入地址：cloudauth.aliyuncs.com（IPv4）或cloudauth-dualstack.aliyuncs.com（IPv6）
請求方法：POST和GET。
傳輸協議：HTTPS。
接口說明：當您收到回調通知之后，可以在服務端通過該接口獲取相應的認證狀態和認證資料。
請求參數
名稱 | 類型 | 是否必選 | 描述 | 示例值 |
SceneId | Long | 是 | 認證場景ID。該ID在控制臺創建認證場景后自動生成。關于如何創建認證場景，請參見添加認證場景。 | 1000000006 |
CertifyId | String | 是 | 實人認證唯一標識。該值需要調用InitFaceVerify-發起認證請求獲取。 | 91707dc296d469ad38e4c5efa6a0**** |
返回數據
名稱 | 類型 | 描述 | 示例值 |
RequestId | String | 請求ID。 | 130A2C10-B9EE-4D84-88E3-5384FF039795 |
Message | String | 請求信息的響應消息。 | success |
Code | String | 返回碼，200指接口響應成功。詳細認證結果判斷，請參見返回Code和Message。 | 200 |
ResultObject.Passed | String | 認證結果。取值：
說明 判斷認證結果請以ResultObject.Passed字段為準。 | T |
ResultObject.SubCode | String | 認證結果描述。更多信息，請參見ResultObject.SubCode錯誤碼說明。
說明 判斷認證結果請以ResultObject.Passed字段為準。 | 200 |
ResultObject.IdentityInfo | String | 認證的主體信息，一般的認證場景返回為空。 | null |
ResultObject.DeviceToken | String | 設備Token。 | McozS1ZWRcRZStlERcZZo_QOytx5jcgZoZJEoRLOxxxxxxx |
ResultObject.DeviceRisk | String | 設備風險標簽。 | ROOT,VPN,HOOK
說明 多個設備風險標簽以半角逗號（,）分隔。如需了解更多設備風險標簽及其含義，請參見人臉保鏢標簽說明。 |
ResultObject.MaterialInfo | String | 認證主體附件信息，主要為圖片類材料。 | {
//是否為攻擊：攻擊為T，非攻擊為F。
"faceAttack": "T",
// 是否有臉部遮擋：有臉部遮擋為T，否則為F。
"faceOcclusion": "F",
// 認證的照片信息。
"facialPictureFront": {
// 人臉攻擊分。
"faceAttackScore": 0.00008597839769208804，
// 人臉和身份證照片比對分（僅當product code=ID_PLUS時，認證完成返回）。
"idCardVerifyScore": 50.99797734769861,
// 照片存放客戶上海區域的OSS里，此為照片的bucket名。
"ossBucketName": "cn-shanghai-aliyun-cloudauth-1260051251634779",
// 照片存放客戶上海區域的OSS里，此為照片的文件名。
"ossObjectName": "verify/1260051251634779/03a081bd96328aedf83f635f39a50c57_0.jpeg",
// 照片https或htttp地址，有效期15分鐘，從查詢時開始計時。
"pictureUrl": "http://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/1260051251634779/03a081bd96328aedf83f635f39a50c57_0.jpeg?Expires=1625371140&OSSAccessKeyId=STS.NTX1ngfr6Acg2Pmnn2RYM****&Signature=Hw5BF9WxJs6wI68IxKs41cxCU8****&security-token=CAISjgJ1q6Ft5B2yfSjIr5ftetTTi60X9qGMMHbcim5nXtZhu7GT1Dz2IH1PdXFgA%2Bgds%2Fswmm5U7vgalrkqEcEdHRGdN5YpsM8LrlzwO1h2TGRsq%2B5qsoasPETOITyZtZagToeUZdfZfejXGDKgvyRvwLz8WCy%2FVli%2BS%2FOggoJmadJlNWvRL0AxZrFsKxBltdUROFbIKP%2BpKWSKuGfLC1dysQcO4gEWq4bHm5fCskKD1Qenk7FO%2B9uuc6LJNZc8YM1NNP6ux%2FFze6b71ypd1gNH7q8ejtYfpGyW5oHHWwIMvErYbbaMrIV1WwZ9Z7knHaVAq%2BXwnOBkuuXYnIns0BdLMuZOSD7YQI2wYWEwgBcxt78agAF%2FHZbelNLYWtipAu5X5oG1t22SqIr1p3TMK5FrjDIVeWOppcxeRXtU%2BjR7hGcwd25scGhiraoxTXV3sxw%2F6dhFSswQ37O4j%2B%2FrCPtiGauqn2ZMdMj%2FvYwKb6KmpQqa%2BtR%2F9cxhS6hoIQRq0SUIfyXl5ZUiZbTjW22iwuX%2BPwzVCw%3D%3D",
// 視頻存放客戶上海區域的OSS里，此為視頻的文件名（僅當客戶端設置視頻參數時返回）。
"ossVerifyVideoObjectName": "verify/1260051251634779/03a081bd96328aedf83f635****_verifyvideo_dcb7.mov",
// 視頻https或htttp地址，有效期15分鐘，從查詢時開始計時（僅當客戶端設置視頻參數時返回）。
"verifyVideoUrl": "http://cn-shanghai-aliyun-cloudauth-1260051251634779.oss-cn-shanghai.aliyuncs.com/verify/1260051251634779/03a081bd96328aedf83f635f39a50c57__verifyvideo_dcb7.mov?Expires=1625371140&OSSAccessKeyId=STS.NTX1ngfr6Acg2Pmnn2RYM****&Signature=Hw5BF9WxJs6wI68IxKs41cxCU8****&security-token=CAISjgJ1q6Ft5B2yfSjIr5ftetTTi60X9qGMMHbcim5nXtZhu7GT1Dz2IH1PdXFgA%2Bgds%2Fswmm5U7vgalrkqEcEdHRGdN5YpsM8LrlzwO1h2TGRsq%2B5qsoasPETOITyZtZagToeUZdfZfejXGDKgvyRvwLz8WCy%2FVli%2BS%2FOggoJmadJlNWvRL0AxZrFsKxBltdUROFbIKP%2BpKWSKuGfLC1dysQcO4gEWq4bHm5fCskKD1Qenk7FO%2B9uuc6LJNZc8YM1NNP6ux%2FFze6b71ypd1gNH7q8ejtYfpGyW5oHHWwIMvErYbbaMrIV1WwZ9Z7knHaVAq%2BXwnOBkuuXYnIns0BdLMuZOSD7YQI2wYWEwgBcxt78agAF%2FHZbelNLYWtipAu5X5oG1t22SqIr1p3TMK5FrjDIVeWOppcxeRXtU%2BjR7hGcwd25scGhiraoxTXV3sxw%2F6dhFSswQ37O4j%2B%2FrCPtiGauqn2ZMdMj%2FvYwKb6KmpQqa%2BtR%2F9cxhS6hoIQRq0SUIfyXl5ZUiZbTjW22iwuX%2BPwzVCw%3D%3D",
// 活體人臉質量分數。
"qualityScore": 99.93476867675781,
// 人臉和公安比對分數，閾值可參考下表詳細說明。
"verifyScore": 57.678396649466755
},
// 身份證OCR信息（僅當product code=ID_PLUS時，認證完成返回OCR識別的信息和圖片）。
"ocrIdCardInfo": {
// 身份證字段信息。
},
"ocrPictureFront": {
// 身份證OCR照片存放客戶上海區域的OSS里，此為身份證OCR照片的Bucket名。
"ossBucketName": "cn-shanghai-aliyun-cloudauth-1234567890",
// 身份證OCR照片存放客戶上海區域的OSS里，此為身份證OCR照片人臉面的文件名。
"ossIdFaceObjectName": "verify/1234567890/f7ed1ef80ad1234fdsd95c66d83340cd_ocridface_b749.jpeg",
// 身份證OCR照片人臉面的https或http地址，有效期15分鐘，從查詢時開始計時。
"ossIdFaceUrl": "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/f7ed1ef80ad1234fdsd95c66d83340cd_ocridface_b749.jpeg?Expires=1625371165&OSSAccessKeyId=STS.NTGterbRtcVY7ykxixaQ6****&Signature=SqZoqBch%2BsdJefkabdaIJrPJWqtD%2FlmF****&security-token=CAISjdfgeJ1q6Ft5B2yfSjIr5fyP9%2FGj41V1JSyNV%2FanGktbd4aqInAmjz2IH1PdXFgA%2Bgds%2Fswmm5U7vgalrkqEcEdHRGdN5YpsM8LrlzwO30McmRsq%2B5qsoasPETOITyZtZagToeUZdfZfejXGDKgvyRvwLz8WCy%2FVli%2BS%2FOggoJmadJlNWvRL0AxZrFsKxBltdUROFbIKP%2BpKWSKuGfLC1dysQcO4gEWq4bHm5fCskKD1Qenk7FO%2B9uuc6LJNZc8YM1NNP6ux%2FFze6b71ypd1gNH7q8ejtYfpGyW5oHHWwIMvErYbbaMrIV1WwZ9Z7knHaVAq%2BXwnOBkuuXYnIns0BdLMuZOSD7YQI2wYWEwgBcxt78agAGe2a1NFO2XabhICqmUeN%2FLV25GuhaexEjjGL4sDC2VWjasWBmKzlXTQ6mHZoI9IhswopdGLLlWPC5ONnLNASWQEObAM28FAViS76clUdE8YVCMyU%2BuyFqLGeRNx4NjcPa%2FlOa9wsxjg4LwlfHKeXA3g0X%2BQQcRAqFc2j093K2r6A%3D%3D",
// 身份證OCR照片存放客戶上海區域的OSS里，此為身份證OCR照片國徽面的文件名。
"ossIdNationalEmblemObjectName": "verify/1234567890/f7ed1ef80ad1234fdsd95c66d83340cd_ocridnationalemblem_a3hf.jpeg",
// 身份證OCR照片國徽面的https或http地址，有效期15分鐘，從查詢時開始計時。
"ossIdNationalEmblemUrl": "http://cn-shanghai-aliyun-cloudauth-1234567890.oss-cn-shanghai.aliyuncs.com/verify/1234567890/f7ed1ef80ad1234fdsd95c66d83340cd_ocridnationalemblem_a3hf.jpeg?Expires=1625371365&OSSAccessKeyId=STS.NTEz8oi35qJpxxX7no5gpGd****&Signature=wnHjNu3333ddW3zNMup1r4ovgrw6xJ0****&security-token=CAISjgJ1q6Ft5B2yfSjIr5fwMYLbhOwUxoibel7p0246OehcqLL%2BpTz2IH1PdXFgA%2Bgds%2Fswmm5U7vgalrkqEcEdHRGdN5YpsM8LrlzwO34PcmRsq%2B5qsoasPETOITyZtZagToeUZdfZfejXGDKgvyRvwLz8WCy%2FVli%2BS%2FOggoJmadJlNWvRL0AxZrFsKxBltdUROFbIKP%2BpKWSKuGfLC1dysQcO4gEWq4bHm5fCskKD1Qenk7FO%2B9uuc6LJNZc8YM1NNP6ux%2FFze6b71ypd1gNH7q8ejtYfpGyW5oHHWwIMvErYbbaMrIV1WwZ9Z7knHaVAq%2BXwnOBkuuXYnIns0BdLMuZOSD7YQI2wYWEwgBcxt78agAFThVhIcXH8zQiqbYVkTCHpZVRmDHH0mZ%2FMNuGikqSWdK3%2FhaSEvxmO1wyLH9E7mFzoKJErtxTCs453H6PYHO8H3pKOpKgZ0PfWTpJ8OEIJm26fKph%2F%2F3usSUBx5h0Ob17e2XB4BffkOJKQQiU3vXqoOZ6Vlyf7QpEJSvUMXXSKSg%3D%3D"
}
}
|
ResultObject.UserInfo | String | 記錄在生僻字模式下用戶輸入的身份信息與對應編碼。返回數據為JSON格式字符串，姓名中無生僻字返回為空字符串。 | { "number":"610***********1110", "name":"王先生", "verifyName":"王先" } |
設備風險標簽說明
風險類別 | 風險標簽 | 描述 |
設備風險類（Native SDK） | ROOT | 設備疑似ROOT、越獄。 |
HOOK | 設備疑似HOOK。 |
VPN | 設備疑似VPN。 |
Emulator | 設備疑似模擬器。 |
SystemVirtual | 設備系統多開。 |
ThirdVirtual | 設備三方多開。 |
AdbModel | 設備開啟開發者模式。 |
NoSimCard | 設備未插卡。 |
VirtualVideo | 虛擬視頻注入。 |
MirroredScreen | 屏幕錄屏截屏。 |
RiskROM | 高危定制ROM。 |
AutoOperation | 自動化操作。 |
BlackTool | 安裝高危工具。 |
CloudPhone | 云手機。 |
ChargeScreenBright | 手機充電屏幕長亮。 |
ChargeScreenNoSecure | 手機充電無鎖屏密碼。 |
設備風險類（Web SDK） | VirtualBrowser | 疑似虛擬瀏覽器。 |
AutoOperation | 疑似自動化工具。 |
BrowserTampered | 疑似瀏覽器參數被篡改。 |
Debugger | 疑似頁面JS被調試。 |
CookieDisabled | cookie被禁用。 |
Incognito | 瀏覽器處于隱身模式。 |
deviceToken風險類 | TokenIsNull | deviceToken為空。 |
TokenTampered | deviceToken篡改。 |
TokenInvalid | deviceToken無效。 |
TokenExpired | deviceToken過期（7天有效）。 |
其他 | NoRisk | 設備風險較低。 當系統未檢測出上述風險時返回NoRisk標簽。 |
NoTag | 無tag命中。 當因為實人認證系統異常無法獲取風險標簽時，系統自動返回NoTag標簽。 |
ResultObject.SubCode錯誤碼說明
具體說明，請參見ResultObject.SubCode錯誤碼說明。
verifyScore閾值說明
千分之一誤識率 | 萬分之五誤識率 | 萬分之一誤識率 | 十萬分之五誤識率 | 十萬分之一誤識率 | 百萬分之一誤識率 |
70 | 71.5 | 75 | 76.5 | 80 | 85 |
說明 如果您有個性化需求，您可以根據業務情況，參考返回的比對分和閾值，自定義認證結果。
返回Code和Message說明
具體說明，請參見返回Code和Message。