在企业短信推送、外呼营销、账号注册风控、客户信息归档等业务场景中，一些用户手机会出现空号、停机等情况，这时候如果再接着发信息给这些号码，会出现短信资源损耗、外呼接通率低的情况。
运营商在网状态API与全网手机状态查询API，均可对接运营商渠道，查询号码是否在使用，不过二者功会有差异。
一、接口共有能力
两个接口入参设计一致，都使用key+phone作为请求参数，传入手机号即可发起查询，通用能力如下：
营销短信 / 外呼前置过滤空号、停机号码
账号注册、登录场景，判断号码是否有效
二、运营商在网状态API：带归属地的号码核验接口
返回参数
| 参数 | 说明 |
|---|---|
| phone | 手机号码 |
| isp | 运营商 |
| desc | 状态描述 不在网时描述：停机、在网不可用、销号 |
| status | 在网状态，0：在网；1：不在网 |
| province | 省份 |
| city | 城市 |
| zipcode | 邮政编码 |
数据来源：探数API
状态采用两级设计：
status粗粒度区分 0=在网、1=不在网；当号码判定为不在网时，通过outline_status、outline_desc进一步细分原因：停机、在网不可用、销号空号、关机、未知。
分层状态的价值：
status用于快速批量过滤；outline_status区分是永久失效（销号空号）还是临时不可用（停机、关机），方便业务做差异化处理。停机号码可保留客户池，后续重试触达；空号可直接从号码库剔除，节约触达成本。
✅适用场景
- 核验手机号有效性，同时获取省市归属地，完善客户档案。
- 按省份开展营销活动，或者限制部分区域注册，同时校验号码状态+归属地。
- 批量号码清洗：剔除空号、停机号码，降低无效短信和外呼成本。
❌接口短板
无独立字段标识携号转网。
三、全网手机状态查询API：携转识别+呼叫状态检测接口
返回参数
| 名称 | 类型 | 说明 |
|---|---|---|
| phone | string | 手机号码 |
| status | string | 2:正常;3:停机;5:不在网（空号）;6:关机;7:忙音;8:呼叫转移（移动返回全状态，联通 /电信返回部分状态） |
| isp | string | 1：移动；2：联通；3：电信 |
| is_xhzw | string | 是否携号转网，1:是，0:否 |
| isp_real | string | 号码原所属运营商，1：移动；2：联通；3：电信 |
数据来源：探数API
该接口主打通信呼叫维度检测，核心亮点是携号转网专项识别，提供
is_xhzw（是否携号转网）、isp_real（号码原始运营商）两个独立字段。状态编码更加丰富，可识别正常、停机、空号、关机、忙音、呼叫转移。
✅适用场景
外呼前预检测号码关机、忙音、呼叫转移，提前预估接通概率，提升外呼效率。
携号转网号码在短信投递、资费策略上存在差异，接口快速识别携转用户，匹配对应短信通道。
❌接口短板
不提供手机号归属地、邮编信息，如果业务需要地域维度的数据，该接口无法满足。
四、选型建议
- 业务需要号码有效性核验 + 手机号归属地，用于客户建档、区域运营，优先选择【运营商在网状态API】。
- 业务重点是识别携号转网、检测关机/忙音/呼叫转移，用于外呼、短信通道适配、精细化风控，不需要归属地，优先选择【全网手机状态查询API】。
