本文介紹如何通過CheckResult介面查詢認證結果。
介面說明
介面名:CheckResult
要求方法:HTTPS POST
介面說明:當您收到回調通知之後,可以在服務端通過該介面擷取相應的認證狀態和認證資料。
重要ID Verification服務結果預設儲存30天,超期系統自動刪除,請您在認證結束後的30天內查詢認證結果。
QPS限量:API獨享QPS限量,詳情請參見ID Verification服務端API QPS限量說明。
服務地址:
說明內網指的是阿里雲同地區產品之間的內部通訊網路,如果您的商務服務器部署在阿里雲的對應地區,可以通過內網網域名稱訪問 ID Verification 服務,以獲得更安全、穩定的網路通訊品質。
中國香港
公網:
cloudauth-intl.cn-hongkong.aliyuncs.com內網:
cloudauth-intl-vpc.cn-hongkong.aliyuncs.com
線上調試和整合
在調試和整合前,請確保您已完整閱讀使用OpenAPI調試和整合服務端API文檔,充分瞭解API介面在OpenAPI平台的調用方式和SDK及其代碼的擷取方式。
您可以在OpenAPI Explorer中直接運行本介面進行調試,並產生本介面的SDK程式碼範例。
請求參數
名稱 | 類型 | 是否必選 | 描述 | 樣本值 |
MerchantBizId | String | Yes | 您自訂的業務唯一標識,用於後續定位排查問題。支援長度為32位的字母和數位組合,請確保唯一。 說明 阿里雲伺服器不會對該欄位的值進行唯一性檢查。為了更好地跟蹤,強烈建議保證欄位唯一性。 | e0c34a77f5ac40a5aa5e6ed20c35**** |
TransactionId | String | Yes | 整個認證流程的唯一標識。該值需要調用 Initialize 介面擷取。 重要 為避免篡改風險,該值必須使用您Initialize介面時服務端儲存的TransactionId,不建議使用用戶端回調的TransactionId。 | hksb7ba1b28130d24e015d6******** |
IsReturnImage | String | No | 是否需要返回認證圖片資料:
| Y |
返回資料
名稱 | 類型 | 描述 | 樣本值 | |
HTTP Status Code | Integer | HTTP狀態代碼。 | 200 | |
HTTP Body | RequestId | String | 請求ID。 | 130A2C10-B9EE-4D84-88E3-5384FF03**** |
Code | String | Success | ||
Message | String | 返回Code的詳細描述。 | success | |
Result.Passed | String | 認證最終結果,取值:
| Y | |
Result.SubCode | String | 認證結果描述。更多資訊,請參見ResultObject.SubCode錯誤碼說明。 | 200 | |
Result.ExtFaceInfo | String | 活體人臉驗證相關結果資訊。關於JSON格式,請參見右側樣本。更多資訊,請參見ExtFaceInfo。 | | |
ExtFaceInfo
名稱 | 類型 | 描述 | 樣本值 |
faceImg | String | 採集人臉圖片,Base64格式。如在發起介面請求時,參數 | base64格式 |
faceAttack | String | 採集人臉是否涉及活體攻擊:
| N |
faceQuality | Double | 活體人臉品質分數。取值範圍0~100。 | 99.99 |
faceOcclusion | String | 是否有臉部遮擋:
| N |
docVideoUrl | String | 存證OSS下載地址。 說明
| https://aliyun-cloudauth.oss-aliyuncs.com/******.webm |
faceAge | String | 人臉預測的參考年齡,可能存在預測失敗無法返回的情況。 | 30 |
faceGender | String | 人臉圖片預測的性別,可能存在預測失敗無法返回的情況。
| M |
faceAttackScore | Double | Face Service演算法預測的假臉攻擊可能性,分數越高代表假臉的可能性越高。 分值取值:0~100。 | 80 |
guardRiskScore | Double | 人臉保鏢演算法預測的裝置風險可能性,分數越高代表裝置風險越高。 分值取值:0~100。 | 90 |
返回Code
HTTP狀態代碼 | Code | Message描述 |
200 | Success | 請求成功。 |
400 | MissingParameter | 參數不可為空。 |
InvalidParameter | 非法參數。 | |
TransactionIdInvalid | 無效Transaction id。 | |
403 | Forbidden.RAMUserAccessDenied | 需要給RAM使用者授予AliyunAntCloudAuthFullAccess的操作許可權。更多資訊,請參見授權RAM使用者訪問服務。 |
Forbidden.AccountAccessDenied | 確保您開通了ID verifycation,並且保證賬戶未欠費。 | |
Throttling.Api | API限流攔截。 | |
404 | ProcessNotCompleted | 整個認證流程未完成。 |
500 | InternalError | 系統內部錯誤,請反饋工程師排查。 |
ResultObject.SubCode錯誤碼說明
錯誤碼 | 認證記錄是否計費 | 描述和原因建議 |
200 | 是 | 認證通過。 |
205 | 是 | 活體檢測存在風險。 |
206 | 是 | 業務策略限制。 說明 開啟安全模式後,會對認證的裝置等環境進行安全檢測,若檢測到可能存在風險,將判定認證結果不通過。您可以提醒使用者卸載裝置上可能安裝的各種多開、分身、虛擬環境等軟體或外掛程式,恢複裝置系統初始安全環境後重試。 |