IP地址详情V1·本地 API 文档

接口简介

IP地理位置查询API是一个基于纯真CZDB数据库的IP地址定位服务。它支持IPv4和IPv6地址查询，并能够返回国家、省份、城市和运营商信息。该接口可以帮助开发者快速获取IP地址的地理位置信息。

请求说明

请求地址：https://api.xunjinlu.fun/api/ip/cip
请求方法：GET
请求头：无特殊要求，但请确保请求头中的Content-Type为application/json。

请求参数

参数名	类型	是否必填	说明
key	string	是	接口访问密钥（开启密钥访问时必填）
ip	string	否	要查询的 IP 地址（IPv4 或 IPv6），不传则自动获取客户端 IP

返回参数

参数名	类型	说明
code	integer	状态码，200表示成功
msg	string	消息说明
data	object	返回的具体数据
- ip	string	查询的IP地址
- version	string	IP地址版本（IPv4 或 IPv6）
- country	string	国家
- province	string	省份
- city	string	城市
- district	string	区域
- isp	string	运营商
- raw	string	原始地理位置信息
- query_time	string	查询时间

返回示例

成功示例

{
    "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"
    }
}

失败示例

{
    "code": 400,
    "msg": "参数错误",
    "data": {}
}

错误码说明

状态码	说明
200	查询成功
400	参数错误
401	访问密钥错误
403	无权限访问
404	请求地址不存在
500	服务器错误

调用示例

直接访问链接

https://api.xunjinlu.fun/api/ip/cip?key=YOUR_KEY&ip=8.8.8.8

cURL命令示例

curl -X GET "https://api.xunjinlu.fun/api/ip/cip?key=YOUR_KEY&ip=8.8.8.8" -H "Content-Type: application/json"

JavaScript (fetch) 示例

fetch("https://api.xunjinlu.fun/api/ip/cip?key=YOUR_KEY&ip=8.8.8.8")
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

jQuery AJAX 示例

$.ajax({
  url: "https://api.xunjinlu.fun/api/ip/cip?key=YOUR_KEY&ip=8.8.8.8",
  type: "GET",
  dataType: "json",
  success: function(data) {
    console.log(data);
  },
  error: function(error) {
    console.error('Error:', error);
  }
});

Python (requests) 示例

import requests

url = "https://api.xunjinlu.fun/api/ip/cip?key=YOUR_KEY&ip=8.8.8.8"

response = requests.get(url)

data = response.json()

print(data)

PHP (curl) 示例

$url = "https://api.xunjinlu.fun/api/ip/cip?key=YOUR_KEY&ip=8.8.8.8";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);

HTML (iframe) 示例

请注意，以上示例中的YOUR_KEY需要替换为您的实际访问密钥。