運營商在網狀態查詢 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錯誤碼說明：