全部產品
Search

搜尋本產品

    ID Verification：ID_2META

    文件中心

    ID Verification：ID_2META

    更新時間：Sep 30, 2025

    本文介紹身份二要素核驗API介面。​

    身份證二要素核驗

    • 介面名：Id2MetaVerifyIntl

    • 要求方法：POST和GET

    • 傳輸協議：HTTPS

    • 介面說明：身份證二要素核驗，輸入姓名和身份證，返回是否一致。

    • 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程式碼範例。

    請求參數​

    名稱

    類型

    是否必選

    描述

    樣本值

    ProductCode

    String

    是

    接入的產品方案，固定值：ID_2META

    ID_2META

    ParamType

    String

    是

    參數類型。

    normal：原始值（明文）。

    說明

    由於權威資料來源限制，身份二要素核驗不支援MD5加密方式。

    normal

    IdentifyNum

    String

    是

    社會安全號碼。

    說明

    僅支援中國內地居民身份證。

    411***********0001

    UserName

    String

    是

    姓名。

    張*

    返回資料​

    名稱

    類型

    描述

    樣本值

    RequestId

    String

    請求ID。

    130A2C10-B9EE-4D84-88E3-5384FF039795

    Code

    String

    返回Code。

    Success

    Message

    String

    返回Code的詳細描述。

    success

    Result

    Object

    無。

    無

    BizCode

    String

    核驗結果：

    • 1：校正⼀致（計費）

    • 2：校正不⼀致（計費）

    • 3：查⽆記錄（不計費）

    1

    返回Code

    HTTP 狀態代碼

    Code

    描述

    200

    Success

    請求成功。

    400

    MissingParameter

    參數不可為空。

    Forbidden.ExceptionRepeatedInvoke

    異常重複調用次數超限。

    401

    InvalidParameter

    非法參數。

    403

    Forbidden.AccountAccessDenied

    確保您開通了ID verification，並且保證賬戶未欠費。

    Forbidden.RAMUserAccessDenied

    需要給RAM使用者授予 AliyunAntCloudAuthFullAccess 的操作許可權。

    500

    Forbidden.ExceptionDataSource

    權威源服務異常。

    InternalError

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