手机号码检测_实人认证(ID Verification)-阿里云帮助中心

本文介绍号码检测API接口的参数定义和用法。

接口信息

接口名：MobileDetect
服务地址：cloudauth.aliyuncs.com（IPv4）或cloudauth-dualstack.aliyuncs.com（IPv6）
接口说明：传入手机号（可批量），查询号码状态。
QPS限量：API独享QPS限量，详情请参见信息核验接口QPS限量说明。

请求参数

名称

类型

是否必选

描述

示例值

ParamType

String

是

加密方式：

normal：明文不加密
md5：MD5加密

重要

所有参数的密文均取32位小写MD5字符串形式。
不同MD5工具得出的密文可能不同，如果加密前接口可以调通但加密后不行，请尝试更换MD5工具。

normal

Mobiles

String

是

手机号。

说明

最多可输入50个手机号，用英文逗号分隔。

参数形式：

paramType 传 normal 时：传入手机号明文。
paramType 传 md5 时：传入手机号密文。

明文：186****2055
密文：
849169cd3b20621c1c78bd61a11a4fc2

响应参数

名称			类型	描述	示例值
RequestId			String	请求ID。	130A2C10-B9EE-4D84-88E3-5384FF039795
Message			String	返回信息。	success
Code			String	返回码：200为成功，其他为失败。重要此参数代表是否正确调用了接口，详细的返回码说明请参见错误码。业务核验结果请通过ResultObject中的字段查看。	200
ResultObject	ChargeCount		Integer	计费次数，一次请求中所有计费次数。	1
	Items	IspName	String	运营商名称： CMCC：移动 CUCC：联通 CTCC：电信	CMCC
		Mobile	String	手机号。	186****2055
		BizCode	String	查询结果： 1：在网可用 2：非在网可用状态 3：无查询结果	1
		SubCode	String	查询详细结果： 101：可用号 102：空号 103：停机 104：沉默号（近半年不活跃小号，新号，非智能机用户） 105：风险号（长时间关机或未开通语音服务以及易投诉的用户） 301：查无记录	101
		Area	String	手机号归属地（只有明文手机号有）。	云南-大理

返回示例

{
    "code": "200",
    "message": "success",
    "requestId": "AD92B909-DC99-5A31-B925-************",
    "resultObject": {
        "chargeCount": "2",
        "items": [
            {
                "area": "辽宁-大连",
                "bizCode": "1",
                "ispName": "CTCC",
                "mobile": "133********",
                "subCode": "101"
            },
            {
                "area": "内蒙古-赤峰",
                "bizCode": "1",
                "ispName": "CMCC",
                "mobile": "137********",
                "subCode": "101"
            }
        ]
    }
}

SDK调用示例

重要

集成前请确认您已获取AccessKey，并已配置环境变量。具体操作，请参见：

接口在线调试和SDK示例：OpenAPI平台
关于SDK示例和安装包获取：
您可以在OpenAPI的在线接口调试页面的右侧找到对应的SDK调用示例，并在代码示例的右上角点击SDK安装信息查看SDK的安装信息。
如果您有离线安装的需求，可以进入SDK安装页面选择需要语言的SDK，并转到发布地址获取。
各编程语言调用示例：代码示例工程

接口信息

请求参数

响应参数

返回示例

SDK​调用示例

SDK调用示例