接口简介
提供手机号码归属地查询功能,可获取手机号段、归属省份/城市、运营商、区号、邮编等详细信息。
接口基本信息
项目 | 值 |
---|---|
请求地址 | https://cn.apihz.cn/api/ip/shouji.php |
请求方式 | POST或GET |
接口状态 | ✅ 免费 |
请求参数
参数名 | 必填 | 说明 | 示例值 |
---|---|---|---|
id | 是 | 用户中心的数字ID | 10000000 |
key | 是 | 用户中心通讯秘钥 | 15he5h15ty854j5sr |
phone | 是 | 要查询的手机号(11位) | 13219931963 |
📌 重要提示:
示例中的公共ID/KEY(88888888
)有频次限制,请注册账号获取专属ID/KEY
返回参数
字段 | 说明 |
---|---|
code | 状态码(200成功,400错误) |
msg | 错误提示信息 |
haoduan | 手机号段(前7位) |
shengfen | 归属省份 |
chengshi | 归属城市 |
fuwushang | 运营商(如中国联通) |
quhao | 区号 |
youbian | 邮编 |
qhdm | 区划代码 |
调用示例
1. GET请求示例
bash
复制
# 直接浏览器访问
https://cn.apihz.cn/api/ip/shouji.php?id=88888888&key=88888888&phone=13219931963
2. Python调用示例
python
运行
复制
import requests
url = "https://cn.apihz.cn/api/ip/shouji.php"
params = {
"id": "YOUR_ID", # 替换为实际ID
"key": "YOUR_KEY", # 替换为实际KEY
"phone": "13219931963"
}
response = requests.get(url, params=params)
result = response.json()
print("查询结果:")
print(f"归属地: {result['shengfen']}{result['chengshi']}")
print(f"运营商: {result['fuwushang']}")
print(f"区号: {result['quhao']}")
3. 返回结果示例
json
复制
{
"code": 200,
"haoduan": "1321993",
"shengfen": "四川",
"chengshi": "绵阳",
"fuwushang": "中国联通",
"quhao": "0816",
"qhdm": "510700",
"youbian": "621000"
}
错误处理
状态码 | 错误信息示例 | 解决方案 |
---|---|---|
400 | {"code":400,"msg":"通讯秘钥错误"} | 检查key参数是否正确 |
400 | {"code":400,"msg":"手机号格式错误"} | 检查11位手机号格式 |
使用须知
- 每日调用无上限,但每分钟有限频(建议自备ID/KEY)
- 支持全国所有手机号段(移动/联通/电信/虚拟运营商)
- 数据来源:公开数据
版权声明:本接口由接口盒子(apihz.cn)提供,数据仅供参考,严禁商业滥用。