IP地址详情V1·本地

# IP 地理位置查询 API 接口文档 ## 接口概述 纯真 IP 地理位置查询 API 是一个基于纯真 CZDB 数据库的 IP 地址定位服务。支持 IPv4 和 IPv6 地址查询，可返回国家、省份、城市、区县和运营商信息。 ## 接口地址 ``` GET/POST https://api.xunjinlu.fun/ip/cip/ ``` ## 请求方式 - `GET` - 通过 URL 参数传递查询参数 - `POST` - 通过表单数据传递查询参数 ## 请求参数 | 参数名 | 类型 | 必填 | 说明 | 示例 | |--------|------|------|------|------| | ip | string | 否 | 要查询的 IP 地址（IPv4 或 IPv6），不传则自动获取客户端 IP | 8.8.8.8 | ### 支持的 IP 格式 | 格式 | 示例 | 说明 | |------|------|------| | IPv4 | `8.8.8.8` | 标准 IPv4 地址格式 | | IPv6 | `2001:4860:4860::8888` | 标准 IPv6 地址格式 | > ⚠️ **注意**：本接口仅支持少量查询，不支持批量查询。 ## 响应参数 ### 成功响应示例 ```json { "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" } } ``` ### 错误响应示例 **IP 格式无效** ```json { "code": 400, "msg": "IP 地址格式无效，请提供有效的 IPv4 或 IPv6 地址", "data": null, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` **IP 信息未找到** ```json { "code": 404, "msg": "未找到该 IP 地址的地理位置信息", "data": null, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ## 响应字段说明 ### data 字段（成功响应） | 字段 | 类型 | 说明 | |------|------|------| | ip | string | 查询的 IP 地址 | | version | string | IP 版本，IPv4 或 IPv6 | | country | string | 国家名称 | | province | string | 省份/州名称 | | city | string | 城市名称 | | district | string | 区县名称 | | isp | string | 运营商/ISP 名称 | | raw | string | 原始地理位置字符串 | | query_time | string | 查询时间（格式：Y-m-d H:i:s） | ## 错误码说明 | 错误码 | 描述 | |--------|------| | 200 | 查询成功 | | 400 | IP 地址格式无效 | | 404 | 未找到该 IP 的地理位置信息 | | 405 | 请求方法不允许，仅支持 GET 或 POST | | 500 | 服务器内部错误 | ## 使用示例 ### GET 请求 ```bash # 查询指定 IP curl "https://api.xunjinlu.fun/ip/cip/?ip=8.8.8.8" # 查询客户端 IP（不传 ip 参数） curl "https://api.xunjinlu.fun/ip/cip/" ``` ### POST 请求 ```bash curl -X POST "https://api.xunjinlu.fun/ip/cip/" \ -d "ip=223.5.5.5" ``` ### PHP ```php '223.5.5.5']); $options = [ 'http' => [ 'method' => 'POST', 'header' => 'Content-Type: application/x-www-form-urlencoded', 'content' => $postData ] ]; $response = file_get_contents('https://api.xunjinlu.fun/ip/cip/', false, stream_context_create($options)); $data = json_decode($response, true); print_r($data); ``` ## 注意事项 1. 本接口仅支持少量查询，不支持批量查询 2. 接口返回 UTF-8 编码的 JSON 数据 3. 支持跨域访问（CORS） --- **开发者**：尋鯨錄 **博客**：[https://www.xunjinlu.fun](https://www.xunjinlu.fun) **API 平台**：[https://api.xunjinlu.fun](https://api.xunjinlu.fun)

# IP地址详情V1·本地 API 文档 ## 接口简介 IP地理位置查询API是一个基于纯真CZDB数据库的IP地址定位服务。它支持IPv4和IPv6地址查询，并能够返回国家、省份、城市和运营商信息。该接口可以帮助开发者快速获取IP地址的地理位置信息。 ## 请求说明 - **请求地址**：[https://api.xunjinlu.fun/api/ip/cip](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 | 查询时间 | ## 返回示例 ### 成功示例 ```json { "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" } } ``` ### 失败示例 ```json { "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](https://api.xunjinlu.fun/api/ip/cip?key=YOUR_KEY&ip=8.8.8.8) ### cURL命令示例 ```bash 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) 示例 ```javascript 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 示例 ```javascript $.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) 示例 ```python 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) 示例 ```php $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) 示例 ```html ``` 请注意，以上示例中的`YOUR_KEY`需要替换为您的实际访问密钥。