从申请到调用：空号检测 API 使用教程

news2024/11/18 14:02:22

引言

在当今数字化的时代，手机号码成为了我们日常生活和商业活动中重要的联系方式之一。然而，随着电话号码的泛滥和变动性，验证手机号码的有效性变得越来越重要。

本文将深入探讨空号检测API 的背景和应用场景，介绍如何使用该 API 来验证手机号码的活跃状态，并分享一些相关的代码示例和最佳实践。无论您是一个开发者、企业主还是普通用户，通过了解和运用空号检测API，您将能够更好地管理和保护手机号码的有效性，提升您的通信和业务的质量。

空号检测 API 简介

空号检测 API 也称号码检测，空号过滤，号码筛选等，是基于运营商大数据及流量使用情况返回手机号码状态，比如：实号、空号、风险号等。

应用场景举例

空号检测已经广泛被使用于短信群发、电话营销、呼叫中心外包、金融信贷、企业名录等行业，帮助企业有效提高了沟通效率和成交率，降低了营销成本和客户投诉率。

还有其他可能的应用场景如还可以应用于物流信息的监控、智能决策等领域，帮助相关企业更好地管理物流业务。

空号检测 API 接入教程

APISpace 是国内一个较大的 API 供应平台，提供多种类型的 API 接口，包括手机号码归属地查询 API 、天气预报查询API、手机在网状态 API 、反欺诈（羊毛盾）API 以及当前比较热门的 AI 绘画 API 等等，感兴趣的小伙伴可以去官网体验一下。

1.申请 API 密钥

用户需要在 API 提供商的官方网站进行注册，并申请 API 密钥，获得 API 接口调用的权限。

进入空号检测 API 详情页，点击【免费试用】或者【注册】都可以获取 API 密钥。

注册成功后，我们在页面导航菜单点击 【我的 API】进入 【访问控制】页面，即可看到平台提供的密钥。

2.在线测试 API

点击免费试用成功后，系统会自动进入 API 的测试界面，如下图，我们只需要填入手机号码就能获取检测结果：

3.使用代码接入 API 接口 - Java 方式

OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
RequestBody body = RequestBody.create(mediaType, "mobiles=13100000000&type=");
Request request = new Request.Builder()
  .url("https://eolink.o.apispace.com/konghao/batch-ucheck")
  .method("POST",body)
  .addHeader("X-APISpace-Token","") // 使用APISpace 提供的 API 密钥
  .addHeader("Authorization-Type","apikey")
  .addHeader("Content-Type","application/x-www-form-urlencoded")
  .build();

Response response = client.newCall(request).execute();
System.out.println(response.body().string());

返回示例

{
    "chargeStatus": 1,
    "chargeCount": 1,
    "message": "成功",
    "data": [{
        "mobile": "13100000000",
        "lastTime": "1683407802109",
        "area": "山西-太原",
        "numberType": "中国联通",
        "chargesStatus": "1",
        "status": "1"
    }],
    "code": "200000"
}

其中 status 代表检测结果，枚举值： 0：空号 1：实号 2：停机 3：库无 4：沉默号 5：风险号