POSTmobile-status-check
手机号在网状态查询
查询手机号码的在网状态，包括是否正常使用、停机或空号等信息，帮助企业验证号码有效性。
接入文件
手机号在网状态查询
功能介绍
本接口提供实时的手机号码在网状态查询服务。通过输入手机号码，系统将返回该号码在运营商网络中的当前状态，例如正常使用（在网）、停机、空号、关机、号码不存在等。此功能旨在帮助企业和开发者快速、准确地识别手机号码的有效性，避免向无效号码发送信息或进行不必要的资源投入。
应用场景
- 营销活动: 在进行短信营销、电话外呼或APP推送前，批量检测目标手机号的有效性，确保营销资源投入到真实活跃的用户，提高触达率和转化率。
- 用户注册与登录: 在用户注册或登录环节，验证用户输入的手机号码是否为真实有效号码，有效防范虚假注册和恶意攻击。
- 风险控制: 金融、电商等行业可利用此接口对用户提交的手机号进行风险评估，识别潜在的风险用户或欺诈行为。
- 数据清洗与维护: 定期对用户数据库中的手机号码进行在网状态核查，及时清理无效、停机或空号，优化数据质量，减少运营成本。
- 实名认证: 作为实名认证流程的辅助环节，验证用户手机号的真实使用状态，提高认证的可靠性。
接入示例程式碼
提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。
請求示例
{}響應示例
{
"code": 200,
"data": {
"result": {
"type": "string",
"example": "1",
"description": "0销号或未启用(不在网)，1正常，2停机，3在网但不可用，4预销号 5关机"
},
"channel": {
"type": "string",
"example": "移动",
"description": "移动，电信，联通，广电"
},
"orderNo": {
"type": "string",
"example": "202406282055560705659"
},
"resultMsg": {
"type": "string",
"example": "正常"
},
"transferStatus": {
"type": "string",
"example": "0",
"description": "0未转网 1转网"
}
},
"message": "success"
}響應欄位
以下欄位根據示例 JSON 自動提取，僅作接入參考。
| 欄位路徑 | 型別 | 示例值 |
|---|---|---|
| code | number | 200 |
| data | object | {...} |
| data.result | object | {...} |
| data.result.type | string | string |
| data.result.example | string | 1 |
| data.result.description | string | 0销号或未启用(不在网)，1正常，2停机，3在网但不可用，4预销号 5关机 |
| data.channel | object | {...} |
| data.channel.type |