全球IP归属地查询免费API详细指南

<?php
/**
 * 全球IP归属地查询 - PHP示例
 * 需要确保服务器支持cURL扩展
 */
class IPQuery {
    private $apiUrl = 'https://cn.apihz.cn/api/ip/chaapi.php';
    private $userId = '你的用户ID'; // 替换为实际用户ID
    private $userKey = '你的用户KEY'; // 替换为实际用户KEY
    
    /**
     * 查询IP归属地信息
     * @param string $ip 要查询的IP地址，为空则查询本机IP
     * @param int $channel 查询通道(0-2)，默认0为综合通道
     * @return array 解析后的IP信息数组
     */
    public function query($ip = '', $channel = 0) {
        // 构建请求参数
        $params = array(
            'id' => $this->userId,
            'key' => $this->userKey,
            'td' => $channel
        );
        
        if (!empty($ip)) {
            $params['ip'] = $ip;
        }
        
        // 构建请求URL
        $url = $this->apiUrl . '?' . http_build_query($params);
        
        // 发起GET请求
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, 10);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
        
        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        
        if (curl_error($ch)) {
            return array('code' => 400, 'msg' => '请求失败: ' . curl_error($ch));
        }
        
        curl_close($ch);
        
        // 解析返回的JSON数据
        $result = json_decode($response, true);
        
        if (json_last_error() !== JSON_ERROR_NONE) {
            return array('code' => 400, 'msg' => 'JSON解析失败: ' . json_last_error_msg());
        }
        
        return $result;
    }
}
// 使用示例
$ipQuery = new IPQuery();
// 查询指定IP
$result = $ipQuery->query('112.192.49.243');
// 查询本机IP
// $result = $ipQuery->query();
if ($result['code'] == 200) {
    echo "查询成功:\n";
    echo "IP: " . $result['ip'] . "\n";
    echo "位置: " . $result['guo'] . "-" . $result['sheng'] . "-" . $result['shi'] . "\n";
    echo "运营商: " . $result['isp'] . "\n";
    echo "经纬度: " . $result['lat'] . ", " . $result['lon'] . "\n";
} else {
    echo "查询失败: " . $result['msg'] . "\n";
}
?>

#!/usr/bin/env python3
"""
全球IP归属地查询 - Python示例
需要安装requests库: pip install requests
"""
import requests
import json
class IPQuery:
    def __init__(self, user_id, user_key):
        self.api_url = "https://cn.apihz.cn/api/ip/chaapi.php"
        self.user_id = user_id
        self.user_key = user_key
    
    def query(self, ip="", channel=0):
        """
        查询IP归属地信息
        :param ip: 要查询的IP地址，为空则查询本机IP
        :param channel: 查询通道(0-2)，默认0为综合通道
        :return: 解析后的IP信息字典
        """
        # 构建请求参数
        params = {
            'id': self.user_id,
            'key': self.user_key,
            'td': channel
        }
        
        if ip:
            params['ip'] = ip
        
        try:
            # 发起GET请求
            response = requests.get(
                self.api_url, 
                params=params, 
                timeout=10,
                verify=False  # 可根据需要设置为True以验证SSL证书
            )
            
            # 检查HTTP状态码
            if response.status_code != 200:
                return {
                    'code': 400, 
                    'msg': f'HTTP请求失败，状态码: {response.status_code}'
                }
            
            # 解析JSON响应
            result = response.json()
            return result
            
        except requests.exceptions.RequestException as e:
            return {'code': 400, 'msg': f'请求异常: {str(e)}'}
        except json.JSONDecodeError as e:
            return {'code': 400, 'msg': f'JSON解析失败: {str(e)}'}
# 使用示例
if __name__ == "__main__":
    # 替换为你的实际用户ID和KEY
    USER_ID = "你的用户ID"
    USER_KEY = "你的用户KEY"
    
    ip_query = IPQuery(USER_ID, USER_KEY)
    
    # 查询指定IP
    result = ip_query.query("112.192.49.243")
    
    # 查询本机IP
    # result = ip_query.query()
    
    if result.get('code') == 200:
        print("查询成功:")
        print(f"IP: {result.get('ip', '未知')}")
        print(f"位置: {result.get('guo', '未知')}-{result.get('sheng', '未知')}-{result.get('shi', '未知')}")
        print(f"运营商: {result.get('isp', '未知')}")
        print(f"经纬度: {result.get('lat', '未知')}, {result.get('lon', '未知')}")
        print(f"完整信息: {result.get('msg', '未知')}")
    else:
        print(f"查询失败: {result.get('msg', '未知错误')}")