API 调用示例（本站域名：）

API调用示例生成器

最多支持10个IP，支持IPv4/IPv6混合查询

范围：1-10，默认10

接口基础信息

  • 完整接口地址：

    自动适配当前域名，无需手动修改

  • 请求方式： GET（推荐） / POST
  • 返回格式：
    • json：默认格式，英文键名（推荐开发使用）
    • cn：中文键名，便于阅读
    • text：纯文本格式，便于日志输出
  • 响应速度： 平均 50-200ms，批量查询按IP数量递增

请求参数（GET/POST通用）

参数名 是否必填 类型 说明 示例值
ip 是 字符串 要查询的IP地址，多个IP用|分隔
支持IPv4/IPv6格式		 223.247.32.216|2400:3200::1
style 否 字符串 输出样式：json/cn/text
默认值：json		 cn
limit 否 整数 查询数量上限（1-10）
默认值：10（系统最大值）		 5

完整调用示例（按格式分类）

1. 默认JSON格式（英文键名）

请求地址：

返回示例：

{
    "ip_start": "223.247.32.216",
    "ip_end": "223.247.32.217",
    "ip_start_num": "3757514968",
    "ip_end_num": "3757514969",
    "continent": "亚洲",
    "country": "中国",
    "province": "广东",
    "city": "深圳",
    "district": "宝安区",
    "isp": "电信",
    "longitude": "113.88311",
    "latitude": "22.55371",
    "area_code": "440306",
    "city_code": "0755",
    "zip_code": "518100",
    "time_zone": "Asia/Shanghai",
    "currency": "CNY",
    "elevation": "11",
    "weather_station": "CHXX0120",
    "alpha2_code": "CN",
    "error": "无数据",
    "ip_version": "v4"
}

2. 中文键名格式（易读）

请求地址：

返回示例：

{
    "ip块起始ip": "223.247.32.216",
    "ip块结束ip": "223.247.32.217",
    "ip块起始ip整形": "3757514968",
    "ip块结束ip整形": "3757514969",
    "所属的七大洲": "亚洲",
    "国家": "中国",
    "省份": "广东",
    "城市": "深圳",
    "区县": "宝安区",
    "互联网供应商": "电信",
    "经度": "113.88311",
    "纬度": "22.55371",
    "行政区码": "440306",
    "电话和区号": "0755",
    "邮编": "518100",
    "时区": "Asia/Shanghai",
    "货币": "CNY",
    "海拔": "11",
    "气象站": "CHXX0120",
    "国家简称": "CN",
    "错误信息": "无数据",
    "IP版本": "v4"
}

3. 纯文本格式（日志友好）

请求地址：

返回示例：

========== 查询 IP：223.247.32.216 ==========
ip块起始ip：223.247.32.216
ip块结束ip：223.247.32.217
ip块起始ip整形：3757514968
ip块结束ip整形：3757514969
所属的七大洲：亚洲
国家：中国
省份：广东
城市：深圳
区县：宝安区
互联网供应商：电信
经度：113.88311
纬度：22.55371
行政区码：440306
电话和区号：0755
邮编：518100
时区：Asia/Shanghai
货币：CNY
海拔：11
气象站：CHXX0120
国家简称：CN
错误信息：无数据
IP版本：v4

4. 多IP批量查询（最多10个）

请求地址（指定JSON格式）：

请求地址（指定中文格式）：

返回说明：

  • 返回数组格式，每个元素对应一个IP的查询结果
  • limit参数限制最多返回3个结果（即使传入更多IP）
  • style参数控制返回格式，支持json/cn/text三种类型
  • 支持混合IPv4/IPv6地址查询

多语言调用示例

PHP 调用示例

<?php
// 配置参数
$apiUrl = '';
$ipList = '223.247.32.216|2400:3200::1'; // 要查询的IP列表
$style = 'json'; // 返回格式
$limit = 2; // 查询上限

// 拼接请求URL
$requestUrl = $apiUrl . '?ip=' . urlencode($ipList) . '&style=' . $style . '&limit=' . $limit;

// 初始化curl
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $requestUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 5); // 超时时间5秒
// 生产环境建议开启SSL验证
// curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
// curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);

// 发送请求
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// 处理响应
if ($httpCode == 200 && $response) {
    $result = json_decode($response, true);
    echo "查询成功：\n";
    print_r($result);
} else {
    echo "查询失败，HTTP状态码：{$httpCode}\n";
}
?>

JavaScript (Fetch) 调用示例

// 配置参数
const apiUrl = '';
const ipList = '223.247.32.216|2400:3200::1';
const style = 'json';
const limit = 2;

// 拼接请求参数
const params = new URLSearchParams({
    ip: ipList,
    style: style,
    limit: limit
});

// 发送请求
fetch(`${apiUrl}?${params}`)
    .then(response => {
        if (!response.ok) {
            throw new Error(`HTTP错误，状态码：${response.status}`);
        }
        return response.json();
    })
    .then(data => {
        console.log('查询结果：', data);
        // 处理返回数据
    })
    .catch(error => {
        console.error('查询失败：', error);
    });

Python 调用示例

import requests
import json

# 配置参数
api_url = ''
ip_list = '223.247.32.216|2400:3200::1'
style = 'json'
limit = 2

# 构造请求参数
params = {
    'ip': ip_list,
    'style': style,
    'limit': limit
}

try:
    # 发送请求
    response = requests.get(api_url, params=params, timeout=5)
    response.raise_for_status() # 抛出HTTP错误
    
    # 解析响应
    result = response.json()
    print("查询成功：")
    print(json.dumps(result, ensure_ascii=False, indent=2))
    
except requests.exceptions.RequestException as e:
    print(f"查询失败：{e}")

错误码说明

错误信息 原因 解决方案
请传入有效的 IP 地址参数 ip参数为空或全是空白字符 检查ip参数是否正确传递
IP 地址格式非法 IP地址不符合IPv4/IPv6规范 检查IP格式，如：223.247.32.216（IPv4）、2400:3200::1（IPv6）
未查询到该 IP 的地理位置信息 IP地址不在数据库中（多为内网/保留IP） 确认IP为公网IP，或更新数据库
网络请求失败 服务器不可达/超时/权限问题 检查API地址是否正确，服务器是否正常运行