一、业务痛点
对于电销客服企业以及互联网平台而言，号码库质量会直接影响运营成本与业务安全。
开展群发短信、批量电话外呼业务时，客户号码库中混杂大量空号、停机号码。企业投入通信成本与人力时间，却无法触达真实用户，整体营销转化与触达效率被拉低。
线上活动注册环节，部分用户会利用失效手机号批量注册账号，刷取优惠券、参与活动薅取福利，生成大量虚假账号，直接推高企业活动运营成本，带来风控压力。
二、接口介绍
探数API的手机号在网状态查询 API，输入手机号即可返回号码状态：正常在用、停机、空号、等结果。可以批量筛查号码，过滤无效号码，优化短信触达效果。无需自建运营商数据源，省去数据对接、维护成本。戳这里查看
最佳实践：对检测结果做缓存，相同号码短期内重复检测减少调用量；做好接口异常、超时、限流逻辑处理。
三、简单调用示例（Java）
public static void main(String[] args) {
String host = "https://tsphone3.market.alicloudapi.com";
String path = "/phone_online";
String method = "GET";
String appcode = "你自己的AppCode";
Map<String, String> headers = new HashMap<String, String>();
//最后在header中的格式(中间是英文空格)为Authorization:APPCODE
headers.put("Authorization", "APPCODE " + appcode);
Map<String, String> querys = new HashMap<String, String>();
querys.put("phone", "1857……3451");
try {
/**
* 重要提示如下:
* HttpUtils请从
* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java
* 下载
*
* 相应的依赖请参照
* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml
*/
HttpResponse response = HttpUtils.doGet(host, path, method, headers, querys);
System.out.println(response.toString());
//获取response的body
//System.out.println(EntityUtils.toString(response.getEntity()));
} catch (Exception e) {
e.printStackTrace();
}
}
四、参数说明
请求参数
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| key | 是 | string | 个人中心查看 |
| phone | 是 | string | 手机号 |
返回参数
| 字段 | 类型 | 说明 |
|---|---|---|
| phone | string | 查询手机号 |
| isp | string | 运营商：移动、电信、联通、广电 |
| desc | string | 主状态描述：在网 / 不在网 |
| status | int | 主在网状态：0 = 在网；1 = 不在网 |
| outline_status | int | 不在网细分状态，仅 status=1 有效1：停机2：在网不可用3：空号 (销号)4：关机5：未知 |
| outline_desc | string | 不在网细分文字描述，仅 status=1 有效：停机、在网不可用、空号 (销号)、关机、未知 |
| province | string | 省份 |
| city | string | 城市 |
| zipcode | string | 邮政编码 |
JSON返回示例
{
"code": 1,
"msg": "操作成功",
"data": {
"phone": "1857……11",
"isp": "联通", //运营商
"desc": "正常", //状态描述 不在网时描述：停机、在网不可用、销号
"status": 0, //在网状态，0：在网；1：不在网
"province": "广西",
"city": "南宁市",
"zipcode": "530000"
}
}
六、典型企业落地场景
- 短信营销 / 消息推送：批量过滤空号停机号码，减少短信损耗，提升消息触达率，降低短信资费成本。
- 业务注册风控：注册环节核验手机号真实可用状态，拦截废弃号码注册，降低虚假账号风险。
- 金融信贷风控：贷前、贷后核验客户联系号码有效性，评估客户联系可达性，完善风控维度。
- 存量客户治理：对历史存量用户号码做批量清洗，清理失效客户数据，优化客户资料库。
- 电销回访业务：提前筛选有效号码，减少坐席拨打无效电话，提升外呼工作效率。
