全部產品
Search

搜尋本產品

    ID Verification：CheckResult

    文件中心

    ID Verification：CheckResult

    更新時間：Dec 25, 2025

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

    • N：不需要（預設）

    Y

    返回資料

    名稱

    類型

    描述

    樣本值

    HTTP Status Code

    Integer

    HTTP狀態代碼。

    200

    HTTP Body

    RequestId

    String

    請求ID。

    130A2C10-B9EE-4D84-88E3-5384FF03****

    Code

    String

    返回Code。

    Success

    Message

    String

    返回Code的詳細描述。

    success

    Result.Passed

    String

    認證最終結果，取值：

    • Y：通過

    • N：不通過

    Y

    Result.SubCode

    String

    認證結果描述。更多資訊，請參見ResultObject.SubCode錯誤碼說明。

    200

    Result.ExtFaceInfo

    String

    活體人臉驗證相關結果資訊。關於JSON格式，請參見右側樣本。更多資訊，請參見ExtFaceInfo。

    {
  "faceAttack": "N",
  "faceComparisonScore": 99.99,
  "faceImg": "base64格式",
  "facePassed": "Y",
  "faceQuality": 95.45,
  "faceOcclusion": "N",
  "docVideoUrl": "https://aliyun-cloudauth.oss-aliyuncs.com/******.webm"
}

    ExtFaceInfo

    名稱

    類型

    描述

    樣本值

    facePassed

    String

    掃臉階段的活體人臉驗證最終結果：

    • Y：通過

    • N：不通過

    Y

    faceComparisonScore

    Double

    採集人臉和證件人像比對分。比對分取值範圍0～100。

    說明

    分數越高代表相同人臉機率越高，預設閾值90 ，您也可以基於業務樣本資料自訂處理。

    99.99

    faceImg

    String

    採集人臉圖片，Base64格式。如在發起介面請求時，參數isReturnImage=Y且掃臉流程順利完成，則返回此欄位。

    base64格式

    faceAttack

    String

    採集人臉是否涉及活體攻擊：

    • Y：涉及攻擊

    • N：不涉及

    N

    faceQuality

    Double

    活體人臉品質分數。取值範圍0～100。

    99.99

    faceOcclusion

    String

    是否有臉部遮擋：

    • Y：有遮擋

    • N：無遮擋

    N

    docVideoUrl

    String

    存證OSS下載地址。

    說明

    • 存證視頻URL有效期間15分鐘。

    • 在認證完成後30分鐘內，可重複查詢擷取。超過30分鐘，系統將自動刪除存證視頻檔案且無法恢複，請及時下載儲存。

    https://aliyun-cloudauth.oss-aliyuncs.com/******.webm

    faceAge

    String

    人臉預測的參考年齡，可能存在預測失敗無法返回的情況。

    30

    faceGender

    String

    人臉圖片預測的性別，可能存在預測失敗無法返回的情況。

    • M：男

    • F：女

    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

    是

    認證通過。

    204

    是

    人臉比對不一致。可能不是同一人或活體照片品質較低。

    205

    是

    活體檢測存在風險。

    206

    是

    業務策略限制。

    說明

    開啟安全模式後，會對認證的裝置等環境進行安全檢測，若檢測到可能存在風險，將判定認證結果不通過。您可以提醒使用者卸載裝置上可能安裝的各種多開、分身、虛擬環境等軟體或外掛程式，恢複裝置系統初始安全環境後重試。