全球IP归属地免费查询API使用指南

核心功能​：精准查询IPv4/IPv6归属地信息（包含大洲、国家、省市区、运营商）。

一、接口基础信息

1. ​请求地址​
   https://cn.apihz.cn/api/ip/chaapi.php

2. ​请求方式​
   GET 或 POST

3. ​请求参数​

   名称	参数	必填	说明
   用户ID	id	是	用户中心的数字ID（需注册获取）
   用户KEY	key	是	用户中心的通讯密钥（需注册获取）
   指定IP	ip	否	支持IPv4/IPv6，不填则查询请求接口的IP（例：ip=49.234.56.78）
   查询通道	td	否	0=多通道综合查询（默认），1/2=备用通道（用于修正误差）

4. ​返回参数​

   名称	参数	说明
   状态码	code	200=成功，400=失败
   消息内容	msg	成功返回位置描述，失败返回错误提示
   大洲	zhou	例：亚洲
   国家	guo	例：中国
   省	sheng	例：四川省
   市	shi	例：绵阳市
   区	qu	例：江油市
   运营商	isp	例：中国联通
   纬度	lat	例：31.780729760241
   经度	lon	例：104.742802217388
   国家代码	guocode	例：CN
   IP	ip	被查询的IP地址
   内部参数	td	实际使用的查询通道（如1-1）

二、调用示例（Python）

python

运行

复制

import requests

# 配置参数（需替换为您注册的id和key）
params = {
    "id": "88888888",      # 替换为您的用户ID
    "key": "88888888",     # 替换为您的用户KEY
    "ip": "112.192.49.243",  # 要查询的IP（可选）
    "td": "0"               # 默认多通道查询
}

# 发送GET请求
response = requests.get("https://cn.apihz.cn/api/ip/chaapi.php", params=params)
result = response.json()

# 解析结果
if result["code"] == 200:
    print(f"IP: {result['ip']}")
    print(f"位置: {result['sheng']}-{result['shi']}-{result['qu']}")
    print(f"运营商: {result['isp']}")
    print(f"经纬度: ({result['lat']}, {result['lon']})")
else:
    print(f"查询失败: {result['msg']}")

三、返回结果示例

​成功响应​（code=200）:

json

复制

{
    "code": 200,
    "zhou": "亚洲",
    "guo": "中国",
    "sheng": "四川省",
    "shi": "绵阳市",
    "qu": "江油市",
    "isp": "中国联通",
    "lat": "31.780729760241",
    "lon": "104.742802217388",
    "msg": "亚洲-中国-四川省-绵阳市-江油市-中国联通",
    "ip": "112.192.49.243",
    "td": "1-1",
    "guocode": "CN"
}

​失败响应​（code=400）:

json

复制

{
    "code": 400,
    "msg": "查询失败,请重试。"
}

四、注意事项

1. ​注册账号​：
   公共ID/KEY（如88888888）有频次限制，请前往接口盒子官网注册获取专属ID和KEY。

2. ​频次限制​：

   • 使用公共ID/KEY：共享每分钟调用限制（易触发限流）。
   • 使用自有ID/KEY：独享每分钟调用频次，无每日上限。

3. ​通道选择​：

   • 默认td=0（多通道综合查询）精度最高，若结果异常可尝试td=1或td=2。

​版权说明​：数据来源于接口盒子官方IP库，详情参考官方文档。