全部产品
Search
文档中心

ID Verification:服务端API接口

更新时间:Jan 09, 2026

本文介绍地址验证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