全部產品
Search

搜尋本產品

    ID Verification：CheckResult

    文件中心

    ID Verification：CheckResult

    更新時間：Jan 15, 2026

    本文介紹如何通過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",
  "faceImg": "/9j/4AAQSkZJRgABAQAAAQqviV6oakp8...",
  "faceQuality": 95.45,
  "faceOcclusion": "N",
  "docVideoUrl": "https://aliyun-cloudauth.oss-aliyuncs.com/******.webm" 
}

    ExtFaceInfo

    名稱

    類型

    描述

    樣本值

    facePassed

    String

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

    • Y：通過

    • N：不通過

    Y

    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

    authorityComparisonScore

    Double

    採集人臉和官方權威資料來源比對分。比對分取值範圍0～100。

    說明

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

    99.99

    faceAttackScore

    Double

    Face Service演算法預測的假臉攻擊可能性，分數越高代表假臉的可能性越高。

    分值取值：0~100。

    80

    guardRiskScore

    Double

    人臉保鏢演算法預測的裝置風險可能性，分數越高代表裝置風險越高。

    分值取值：0~100。

    90

    deviceToken

    String

    裝置助手DeviceToken，當SDK完整整合裝置助手模組時返回，可通過該Token 查詢裝置助手服務端介面，擷取裝置風險詳情。

    • 裝置助手為付費服務，具體資訊，請參考產品計費。

    • 此Token 具有7天有效期間且不具備唯一性。

    e0c34a77f5ac40a5aa5e6ed20c35****

    返回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

    系統內部錯誤，請反饋工程師排查。

    503

    ServiceUnavailable

    服務不可用，請反饋工程師排查。

    ResultObject.SubCode錯誤碼說明

    錯誤碼

    認證記錄是否計費

    描述和原因建議

    200

    是

    認證通過。

    201

    是

    官方資料庫中姓名和身份證不一致。可能是使用者的資訊有誤或使用者的資訊為假資訊，建議使用者確認後重新操作。

    說明

    該錯誤碼僅在以下條件下返回：產品驗證的證件類型為中國身份證，且已啟用權威核驗功能。

    202

    是

    官方資料庫查詢不到身份資訊。建議預留人工審核入口，進行人工審核。

    說明

    該錯誤碼僅在以下條件下返回：產品驗證的證件類型為中國身份證，且已啟用權威核驗功能。

    205

    是

    活體檢測存在風險。

    206

    是

    業務策略限制。開啟安全模式後，會對認證的裝置等環境進行安全檢測，若檢測到可能存在風險，則判定認證結果不通過。

    您可以按照如下方法排查處理：

    1. 提醒使用者卸載掉裝置上可能安裝的各種多開、分身、虛擬環境等軟體或外掛程式，恢複裝置系統初始安全環境後重試。

    2. 檢查您使用的包名是否為測試demo包名，如使用了測試demo包名需修改為業務包名，以避免被工程或服務的安全性原則攔截。

    207

    是

    官方資料庫中人臉核驗失敗。可能不是同一人或活體照片品質較低。

    說明

    該錯誤碼僅在以下條件下返回：產品驗證的證件類型為中國身份證，且已啟用權威核驗功能。