运营商在网状态查询 API 接口是一种能够让开发者通过编程方式查询手机号码在运营商网络中当前状态的应用程序接口。该接口是一组规范和协议，允许第三方开发者通过特定的编程方式与运营商的系统进行交互，以查询手机号码在运营商网络中的当前状态。

运营商在网状态查询 API 接口主要功能是查询手机号码的在网状态，通常包括正常使用、停机、欠费、销号、未启用等状态。有些接口还可能提供更详细的信息，如号码的归属地、运营商类型，以及是否为携号转网号码等。

那么接下来我们来聊一聊怎么对接运营商在网状态查询API接口。

首先我们找到一家有运营商在网状态查询API接口的服务商，如数勋API,注册账号，购买免费套餐：

然后让我们技术把运营商在网状态查询API接口对接到系统中，数勋API支持多种编程语言对接，下面以java为例：

package com.shuxun.data.impl.demo;import com.shuxun.common.core.util.HttpUtil;
import org.apache.commons.codec.digest.DigestUtils;import java.util.HashMap;
import java.util.Map;public class MobileStatusQueryDemo {private static final String APP_KEY = "您的appKey";private static final String APP_SECRET = "您的appSecret";private static final String API_URL = "https://api.shuxuntech.com/v1/mobileStatus/query";public static void main(String[] args) {String timestamp = System.currentTimeMillis()+"";String sign = DigestUtils.sha256Hex(APP_KEY + timestamp + APP_SECRET);Map<String, String> header = new HashMap<>(4);header.put("appKey", APP_KEY);header.put("timestamp", timestamp);header.put("sign", sign);Map<String, String> params = new HashMap<>(2);params.put("mobile", "");// 工具类下载地址 https://file.shuxuntech.com/other/code/util.zipString result = HttpUtil.get(API_URL, header, params);System.out.println("返回结果="+result);}
}

对接好后传入手机号码，查询该手机号的在网状态，返回内容有正常使用、停机、在网但不可用、不在网（销号/未启用/异常）、预销户等多种状态。支持携号转网，直连运营商数据源。返回示例如下：

返回字段描述：

data对象说明：

result扫描结果说明：

code错误码说明：