一、用户痛点
从事客户管理、销售管理、外呼系统服务商，以及短信公司、群发平台、培训机构等行业，普遍会遇到以下业务问题👇:
批量发送短信 / 外呼，大量空号、停机号码，白白消耗短信费用、呼叫成本。
大量无效号码拉低整体触达成功率，营销回访、客户通知的效果大打折扣，投入的人力、营销资源得不到对应回报。
这些问题会增加运营成本、降低业务转化效率，是令大部分企业头疼的问题。
二、接口说明
手机号状态检测API：根据客户提供的手机号，分类筛选出其中的空号、实号、风险号和沉默号。戳这里查看
直连运营商权威渠道，非缓存库，稳定可靠，支持高并发。
请求参数
返回参数
三、应用场景
- 短信群发：过滤无效号码，节省短信费用
- CRM / 外呼系统：清理客户号码，减少无效呼叫
- 企业客户：清洗会员库，提高通知触达效果
四、接口使用注意事项
手机号状态解释
| status 值 | 含义 | 业务侧建议 |
|---|---|---|
| 0 | 空号，号码不存在 | 过滤 |
| 1 | 实号 (活跃)，号码正常在用 | 保留 |
| 2 | 停机，号码停机状态 | 建议过滤 |
| 3 | 库无，数据库无该号码记录 | 建议保留，不要直接丢弃 |
| 4 | 沉默 (不常用)，号码存在但极少使用，对移动互联网没有太大的兴趣人群 | 可标记，谨慎使用 |
| 5 | 风险号，长时间关机或未开通语音服务以及易投诉的用户 | 建议过滤 |
常见踩坑总结
| 返回状态 | 常见误区 | 正确处理 |
|---|---|---|
| 3 库无 | 当成空号丢弃 | 保留，数据库没有样本，号码有可能正常在用 |
| 4 沉默号 | 当成停机 | 号码可用，只是活跃度低 |
| 5 风险号 | 100% 是诈骗号 | 历史标签，当前号码可能已经更换机主 |
接口能解决什么，不能解决什么
✅可以解决：批量号码库初步清洗，减少无效触达，节约短信 / 外呼成本。
❌不能解决：
不能获取运营商实时真实状态；
不能做实名认证、风控核验；
不能 100% 保证号码一定可用；
不能判定当前机主真实身份。
五、调用教程
以java为例
public static void main(String[] args) {
String host = "https://market.aliyun.com/detail/cmapi00067360"; //地址
String path = "/phone_invalid";
String method = "GET";
String appcode = "你自己的AppCode";
Map<String, String> headers = new HashMap<String, String>();
//最后在header中的格式(中间是英文空格)为Authorization:APPCODE 83359fd73fe94948385f570e3c139105
headers.put("Authorization", "APPCODE " + appcode);
Map<String, String> querys = new HashMap<String, String>();
querys.put("phone", "13112313213");
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();
}
}
