全部產品
Search
文件中心

ID Verification:服務端API介面

更新時間:Sep 10, 2025

本文介紹地址驗證API介面。地址核驗 API 基於裝置採集及電訊廠商巨量資料能力對檢測裝置歸屬地區及地址資訊進行驗證。

介面資訊

  • 介面名:AddressVerifyV2Intl

  • 介面說明:基於裝置採集及電訊廠商巨量資料能力對檢測裝置歸屬地區及地址資訊進行驗證。

  • 要求方法: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

固定值:ADD_VERIFY_PRO

ADD_VERIFY_PRO

RegCountry

String

禁止國家或者地區列表

目前僅支援:USA

DeviceToken

String

通過用戶端SDK擷取的deviceToken

VerifyType

String

地址核驗方式:

  • HOME:家庭地址核驗

  • WORK:工作地址核驗

HOME

Mobile

String

支援中國手機號碼

1872334****

Text

String

詳細地址常值內容

浙江省杭州市西湖區燈彩街雲穀園區

返回資料

名稱

類型

描述

樣本值

HTTP Status Code

Integer

HTTP狀態代碼。

200

HTTP Body

RequestId

String

請求ID。

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

Code

String

返回Code

Success

Message

String

返回Code的詳細描述。

success

Result.BizCode

String

驗證結果,取值:

  • 1:通過 (計費)

  • 2:不通過(裝置位于禁止地區)(計費)

  • 3:無法判斷 (計費)

1

Result.Detail

String

驗證詳情,包括:

  • DistanceRange:位置區間,詳情見下表DistanceRange說明

    說明

    如果入參手機號、地址為空白或者未查詢到電訊廠商資訊,此項不返回。

  • IspName: 電訊廠商名稱:

    說明

    如果入參手機號、地址為空白或者未查詢到電訊廠商資訊,此項不返回。

    • CMCC:中國移動

    • CTCC:中國電信

    • CUCC:中國聯通

  • PhoneStatus:手機狀態 :

    說明

    如果入參手機號為空白,此項不返回。

    • 0:異常

    • 1:正常

{
  "DistanceRange": "0-3000",
  "IspName": "CTCC", 
  "PhoneStatus": "1" 
}

返回Code

HTTP 狀態代碼

Code

描述

200

Success

請求成功。

400

MissingParameter

參數不可為空。

400

Forbidden.ExceptionRepeatedInvoke

異常重複調用。

401

InvalidParameter

非法參數。

403

Forbidden.AccountAccessDenied

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

403

Forbidden.RAMUserAccessDenied

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

500

InternalError

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

DistanceRange說明

中國電信(CTCC)

距離區間

區間描述

0-3000

0~3KM

3000-5000

3KM~5KM

5000-10000

5KM~10KM

10000-20000

10KM~20KM

20000-50000

20KM~50KM

>50000

大於50KM

中國移動(CMCC)

距離區間

區間描述

0-3000

0~3KM

3000-5000

3KM~5KM

5000-10000

5KM~10KM

10000-20000

10KM~20KM

20000-30000

20KM~30KM

30000-50000

30KM~50KM

>50000

大於50KM

中國聯通(CUCC)

距離區間

區間描述

0-3000

0~3KM

3000-10000

3KM~10KM

10000-20000

10KM~20KM

20000-50000

20KM~50KM

>50000

大於50KM