IP地址详情V1

接口说明

IP 地理位置查询 API 是一个基于纯真 CZDB 数据库的 IP 地址定位服务。支持 IPv4 和 IPv6 地址查询，可返回国家、省份、城市和运营商信息。

本接口为免费接口，但需要提供有效的访问密钥进行鉴权。适用于需要根据 IP 地址获取地理位置信息的各类应用场景，如用户地域分析、访问日志处理、内容分发优化等。

调用地址

https://openapi.xunjinlu.fun/api/ip/cip/index.php

请求方式

GET

密钥要求

必须密钥。调用本接口时必须在请求中携带有效的访问密钥，否则将返回鉴权错误。

鉴权方式

本接口支持以下鉴权方式：

• Query 参数：通过 URL 查询参数传递密钥

计费

免费

分类

IP工具

请求参数

参数说明

• key：您的接口访问密钥，用于身份鉴权和配额管理。密钥可在平台控制台申请和管理。
• ip：需要查询地理位置的 IP 地址。支持 IPv4 和 IPv6 格式。如果不传递此参数，系统将自动使用发起请求的客户端 IP 地址进行查询。

典型取值示例

请求示例

使用 Query 参数鉴权

GET https://openapi.xunjinlu.fun/api/ip/cip/index.php?key=sk_xxxxxxxxxxxxxxxx&ip=8.8.8.8

PHP 示例

// IP地址详情查询示例
$key = 'sk_xxxxxxxxxxxxxxxx';
$ip = '8.8.8.8';

$url = "https://openapi.xunjinlu.fun/api/ip/cip/index.php?key={$key}&ip={$ip}";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result['code'] == 200) {
    echo "IP: " . $result['data']['ip'] . "\n";
    echo "国家: " . $result['data']['country'] . "\n";
    echo "省份: " . $result['data']['province'] . "\n";
    echo "城市: " . $result['data']['city'] . "\n";
    echo "运营商: " . $result['data']['isp'] . "\n";
} else {
    echo "错误: " . $result['msg'] . "\n";
}

成功响应示例

{
    "code": 200,
    "msg": "查询成功",
    "data": {
        "ip": "8.8.8.8",
        "version": "IPv4",
        "country": "美国",
        "province": "加利福尼亚州",
        "city": "山景城",
        "district": "",
        "isp": "Google DNS",
        "raw": "美国–加利福尼亚州–山景城– Google DNS",
        "query_time": "2026-05-12 22:45:30"
    },
    "api_info": {
        "developer": "尋鯨錄",
        "blog": "https://www.xunjinlu.fun",
        "api_platform": "https://api.xunjinlu.fun"
    }
}

响应字段说明

顶层字段

data 对象字段

api_info 对象字段

错误响应示例

当请求出现错误时，接口返回如下格式的 JSON：

{
    "code": 0,
    "msg": "未提供调用密钥",
    "errcode": 11001
}

业务错误码说明

错误码处理建议

注意事项

1. 密钥安全：请妥善保管您的访问密钥，避免泄露。建议不要在客户端代码中硬编码密钥。
2. IP 格式：传入的 IP 地址需为合法的 IPv4 或 IPv6 格式，否则可能返回查询失败。
3. 自动获取 IP：当不传递 ip 参数时，系统将自动使用 HTTP 请求的源 IP 地址进行查询。
4. 数据更新：IP 地理位置数据基于纯真 CZDB 数据库，数据更新频率以数据库发布周期为准。
5. 请求频率：虽然本接口免费，但仍受平台整体请求频率限制，请合理控制调用频率。