前言
在企业营销、用户注册、短信通知等业务场景中，电话号码的有效性直接影响着运营效率和成本控制。如何快速、准确地识别号码状态，成为了很多开发者需要解决的问题。
本文将基于企讯通号码状态实时查询接口，介绍API的接入方式和开发实践。
一、接口概述
号码状态实时查询接口通过信令检测技术，实时查询手机号码的当前在网状态，包括正常、空号、停机、关机等多种状态。
核心特点
- 实时性：直连三大运营商，实时返回查询结果
- 响应快：响应时间约100毫秒
- 多状态：支持9类号码状态检测
- 携号转网：可识别号码是否携号转网
接口地址
http://jk.qxt800.com/ssPhone_Status https://jk.qxt800.com/ssPhone_Status
支持 GET/POST 请求，建议使用 POST 方式，返回 JSON 格式。
二、接口参数说明
请求参数
| 参数名称 | 类型 | 必传 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 用户唯一标识 |
| mobile | string | 是 | 需要查询的号码（单个） |
请求示例
Bash
# GET 方式 http://jk.qxt800.com/ssPhone_Status?apikey=您的apikey&mobile=13900000000 # POST 方式 curl -X POST "https://jk.qxt800.com/ssPhone_Status" \ -d "apikey=您的apikey" \ -d "mobile=13900000000"
三、响应数据说明
响应示例
JSON Response
{ "code": 0, "reason": "Succ", "result": { "Mobile": "13972565391", "Status": "正常", "Area": "湖北-宜昌", "Is_MNP": "1", "Init_isp": "中国移动", "Now_isp": "中国电信" } }响应字段说明
| 字段 | 说明 |
|---|---|
| code | 请求结果，0表示成功 |
| reason | 返回说明，Succ表示请求成功 |
| Mobile | 查询的手机号码 |
| Status | 号码状态 |
| Area | 号码归属地（省-市） |
| Is_MNP | 是否携号转网：1已转网，0未转网 |
| Init_isp | 号码初始运营商 |
| Now_isp | 号码当前运营商 |
号码状态类型
| 状态 | 说明 |
|---|---|
| 正常 | 号码正常在网 |
| 空号 | 号码为空号 |
| 停机 | 号码已停机 |
| 关机 | 号码已关机 |
| 疑似关机 | 疑似关机状态 |
| 未知 | 未知状态（不计费） |
| 异常号码 | 异常号码（不计费） |
| 查询失败 | 查询失败（不计费） |
| 号码不支持 | 号码不支持（不计费） |
四、Python 调用示例
Python
import requests def check_phone_status(apikey, mobile): """查询号码状态""" url = "https://jk.qxt800.com/ssPhone_Status" params = { "apikey": apikey, "mobile": mobile } response = requests.post(url, data=params) return response.json() # 调用示例 result = check_phone_status("您的apikey", "13900000000") print(result)五、余额查询接口
请求地址
HTTP Endpoint
http://jk.qxt800.com/balance
请求参数
| 参数名称 | 类型 | 必传 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 用户唯一标识 |
响应示例
JSON Response
{ "code": 0, "reason": "Succ", "result": { "feeType": "预付费", "balance": "12048" } }六、错误代码说明
| 错误代码 | 含义 |
|---|---|
| 0 | 请求成功 |
| 1 | 请求参数缺失 |
| -1 | apikey 信息不正确 |
| -2 | 手机号码长度不对 |
| -3 | 请填写正确的手机号码 |
| -4 | 未查询到相关信息 |
| -5 | 余额不足 |
| -8 | 系统错误，请稍后重试 |
| -9 | IP地址鉴权失败 |
七、接入注意事项
- 接口编码：统一使用 UTF-8
- 频率控制：建议设置合理的请求频率
- 数据安全：妥善保管 apikey，定期更换
- 合规使用：确保获取用户授权后再进行号码检测
结语
本文介绍了号码状态实时查询API的接入方式，包括接口地址、参数说明、响应格式和错误处理。开发者可根据业务需求快速集成，实现号码状态检测功能。
如需了解更多API详情或获取测试接口，可搜索企讯通获取技术支持。
