全国电信余额查询服务介绍
全国电信余额查询是致查云提供的话费类数据查询服务之一,通过运营商数据通道,输入电信号码即可实时返回该号码当前可用的话费余额,并附带号码归属地信息。
话费余额是衡量号码"活跃价值"的直观指标:在催收场景中,余额长期为零或极低的号码大概率已停机或弃用,可优先降低外呼优先级;在金融风控中,余额变化可用于辅助判断号码使用状态;在客户运营中,批量掌握存量客户号码余额有助于精细化维系。本服务专注电信全国网,与平台内话费余额通道1/2/3(移动、联通为主)形成互补,为您补齐电信覆盖。
返回的核心信息
- 话费余额:号码当前可用余额(元),实时查询
- 归属地:号码归属省份与城市
- 原始响应:raw_response 字段原样透传上游完整响应对象,便于核验与对账
🎯 核心优势
全国电信覆盖
覆盖全国电信用户,携号转网至电信的号码同样支持查询
实时响应
对接运营商数据通道实时查询,小批量同步返回,即调即得
失败不计费
仅对返回有效余额的号码扣费,查询失败与未执行部分自动退款
原始响应透传
每条结果携带 raw_response 字段,上游完整响应原样返回,便于核验与对账
批量处理
单次最多1000个号码,大批量异步队列处理,支持任务进度追踪、取消与终止
安全合规
HTTPS加密传输,严格的权限控制与IP白名单,全面保护用户隐私
技术优势
🔧 API接口特性
我们提供标准化的RESTful API接口,支持HTTP/HTTPS协议,返回JSON格式数据,易于集成到任何业务系统。接口设计遵循行业最佳实践,提供详细的开发文档,技术支持团队全程协助接入。
- 响应方式:≤5个号码同步返回,>5个号码异步队列处理并支持进度查询
- 数据格式:返回标准JSON格式,包含余额、归属地明细与上游原始响应
- 计费透明:每条结果带独立 cost 字段,失败条目 cost=0,账单清晰可对
- 错误处理:完善的错误码体系(INSUFFICIENT_CREDIT/TASK_LIMIT_EXCEEDED等),便于问题排查
- 数据安全:HTTPS加密传输,支持IP白名单,严格的权限控制
📡 数据来源
话费余额数据来源于运营商授权数据通道,覆盖全国电信网络,确保数据的权威性和时效性。
查询返回数据说明
每条查询结果包含以下字段:
| 返回字段 | 字段说明 | 类型 | 示例 |
|---|---|---|---|
| mobile | 查询的手机号 | String | 17312345678 |
| success | 本条是否查询成功 | Boolean | true / false |
| cost | 本条扣费积分(失败为0) | Number | 1.6 |
| money | 话费余额(元) | Number | 58.66 |
| prov | 归属省份 | String | 江苏 |
| city | 归属城市 | String | 南京 |
| isp | 运营商(成功条目为中国电信) | String | 中国电信 |
| error_msg | 失败原因(成功条目无此字段) | String | 该号码不支持查询 |
| raw_response | 上游数据源原始响应 | Object | code/message/data |
API返回数据样本
{
"success": true,
"data": {
"is_sync": true,
"processed_count": 1,
"success_count": 1,
"total_cost": 1.6,
"data": [
{
"mobile": "17312345678",
"success": true,
"cost": 1.6,
"money": 58.66,
"prov": "江苏",
"city": "南京",
"isp": "中国电信",
"raw_response": {
"code": 200,
"message": "查询成功",
"data": { "curFee": "58.66" }
}
}
]
},
"user_info": {
"username": "demo_user",
"balance_after": 98.4
}
}
行业解决方案
🏦 金融风控
在信贷审批与贷后管理中,电信号码的话费余额可辅助判断号码活跃度与用户资质,与其他维度组合构建风控模型。
📞 催收管理
批量查询逾期客户电信号码余额,余额长期为零的号码大概率停机弃用,可优化外呼策略、降低无效触达成本。
🛒 客户运营
掌握存量客户电信号码余额状态,识别高流失风险用户,配合营销策略精细化维系。
📊 数据清洗
对号码库批量体检,剔除无法查询、状态异常的号码,提升下游业务触达效率。
应用场景
🏦 信贷风控
审批环节辅助评估电信号码活跃度,组合多维度数据构建风控模型。
📞 催收优先级排序
按余额状态对逾期客户号码分层,优先外呼高价值活跃号码。
👥 存量客户维护
批量盘点客户号码余额状态,识别流失风险用户及时干预。
📋 号码库清洗
定期批量核验号码库,剔除异常号码,提升营销触达效率。
查询流程
注册账号
访问致查云官网,点击免费注册,完善基本信息后即可获取API调用权限和免费体验额度。
提交查询
登录会员中心,进入全国电信余额查询页面,输入电信号码(支持批量输入或Excel导入),提交查询请求。
系统处理
系统自动对接运营商数据通道,实时查询号码话费余额,小批量同步返回,大批量异步队列处理并实时反馈进度。
获取结果
查询结果实时返回,包含余额、归属地等明细。支持在线查看、导出Excel,也可通过API接口直接集成到业务系统。
API接入指南
我们提供标准化的RESTful API接口,支持HTTP/HTTPS协议,返回JSON格式数据。接入流程如下:
- 注册账号:访问致查云官网,免费注册账号
- 获取API密钥:在会员中心获取API Key
- 查看开发文档:参考API文档了解接口参数和返回格式
- 接口联调:使用测试账号进行接口联调
- 正式上线:联调通过后即可正式上线使用
技术支持团队全程协助接入,遇到问题可通过工单、电话、微信等多种方式获得帮助。
常见问题
全国电信余额查询是面向中国电信号码的话费余额批量查询服务,输入电信号码即可实时获取该号码当前可用的话费余额,覆盖全国电信用户,携号转网至电信的号码同样支持。
仅支持中国电信号码(含携号转网至电信的号码)。非电信号码提交后查询会失败,失败条目不扣费。单次最多支持1000个号码。
每条结果包含:手机号(mobile)、查询是否成功(success)、扣费积分(cost)、话费余额(money,单位元)、归属地(prov/city)、运营商(isp),以及 raw_response 字段——上游数据源HTTP响应体解码后的完整对象,原样透传,可直接按原始字段解析与对账。
支持批量查询,单次最多可提交1000个号码。≤5个号码同步返回结果,>5个号码采用异步队列处理,支持任务进度实时追踪、任务取消与终止,完成后按实际成功条数结算。
不会。只有查询成功(返回有效余额)的号码才会扣费。因号码非电信、归属地未开通查询、号码状态异常、系统问题等原因导致的查询失败,系统不会扣除任何费用,异步任务失败与未执行部分的预扣积分会自动退还。
注册账号后即可获取API密钥和详细的开发文档。我们提供标准化的RESTful API接口,返回JSON格式数据,且每条结果原样携带上游数据源的完整原始响应。技术支持团队全程协助接入。
