IP地址详情V2-街道级

# IP 归属地查询 API 一款高精度 IP 归属地查询接口，支持 IPv4 和 IPv6 双栈查询，可精确到街道级别。 ## 功能特性 - **双栈支持**：同时支持 IPv4 和 IPv6 地址查询，覆盖主流网络环境 - **街道级精度**：返回精确到街道级别的归属地信息，满足精细化定位需求 - **多数据源**：内置多个数据源，智能调度保障查询成功率与响应速度 - **灵活调用**：支持 GET / POST 请求，支持 JSON 和表单两种提交格式 - **随机查询**：支持传入 `random` 关键字，从预设 IP 池中随机选取进行查询 - **数据源可选**：支持手动指定数据源，满足特定场景下的查询需求 - **格式友好**：JSON 响应自动美化缩进，中文原生显示不转义 ## 接口地址 ``` https://api.xunjinlu.fun/api/ip/v2.php ``` ## 请求方式 支持 `GET` 和 `POST`。 ## 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--------|------|------|------| | `ip` | string | 是 | 要查询的 IP 地址（IPv4 或 IPv6），传入 `random` 则随机查询 | | `source` | string | 否 | `source1` / `source2` / `source3`，不传默认智能切换 | ### 数据源 | 数据源 | 支持类型 | 说明 | |--------|---------|------| | source1 | IPv4 | 返回街道级归属地信息 | | source2 | IPv4 | 返回街道级归属地信息 | | source3 | IPv6 | 返回街道级归属地信息 | 不传 `source` 或传 `auto` 时，IPv4 随机选择 source1/source2，IPv6 自动使用 source3。 ## 请求示例 ```bash # IPv4 查询 curl "https://api.xunjinlu.fun/api/ip/v2.php?ip=114.88.43.167" # IPv6 查询 curl "https://api.xunjinlu.fun/api/ip/v2.php?ip=2001:4860:4860::8888" # 随机查询 curl "https://api.xunjinlu.fun/api/ip/v2.php?ip=random" # 指定数据源 curl "https://api.xunjinlu.fun/api/ip/v2.php?ip=114.88.43.167&source=source1" # POST JSON curl -X POST "https://api.xunjinlu.fun/api/ip/v2.php" \ -H "Content-Type: application/json" \ -d '{"ip":"114.88.43.167","source":"source2"}' ``` ## 响应示例 ### 查询成功 ```json { "code": 0, "msg": "查询成功", "time": "2026-05-25 03:09:49", "data": { "ip": "114.88.43.167", "isp": "电信", "country": "中国", "continent": "亚洲", "province": "上海市", "city": "上海市", "district": "浦东新区", "street": "陆家嘴街道", "latitude": "31.24", "longitude": "121.50", "source": "auto" }, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ### 参数错误 ```json { "code": 400, "msg": "缺少参数 ip，请传入要查询的IP地址或传入 ip=random 随机查询", "time": "2026-05-25 03:12:00", "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ## 返回字段说明 | 字段 | 说明 | |------|------| | `code` | 状态码，`0` 成功，`400` 参数错误，`500` 服务异常 | | `msg` | 提示信息 | | `time` | 响应时间 | | `api_info` | 开发者信息 | | `data.ip` | 查询的 IP 地址 | | `data.isp` | 运营商 | | `data.country` | 国家 | | `data.continent` | 大洲 | | `data.province` | 省份 | | `data.city` | 城市 | | `data.district` | 区/县 | | `data.street` | 街道 | | `data.latitude` | 纬度 | | `data.longitude` | 经度 | | `data.source` | `auto`（智能切换）或 `source1` / `source2` / `source3` | --- - **开发者**：尋鯨錄 - **博客**：[https://www.xunjinlu.fun](https://www.xunjinlu.fun) - **API 平台**：[https://api.xunjinlu.fun](https://api.xunjinlu.fun)

> 声明：本文档由 AI 根据平台配置自动生成；示例为片段。 ## 接口简介 IP地址详情V2-街道级是一款高精度IP归属地查询接口，支持IPv4和IPv6双栈查询，可精确到街道级别。该接口提供丰富的地理位置信息，包括国家、省份、城市、区县、街道等详细数据，同时返回经纬度坐标和完整地址描述。接口适用于需要精准定位用户地理位置的业务场景，如内容本地化、风控系统、数据分析等。开发者可通过简单的API调用获取IP地址的详细地理位置信息。 ## 请求说明 - **方法**：GET, POST - **请求头**：Content-Type: application/json（当使用POST方法时） - **请求地址**：https://api.xunjinlu.fun/api/ip/v2.php ## 请求参数表 | 参数名 | 类型 | 必填 | 说明 | |--------|------|------|------| | key | string | 是 | 接口访问密钥（开启密钥访问时必填） | | ip | string | 是 | 要查询的IP地址（IPv4或IPv6） | ## 返回字段表 | 字段名 | 类型 | 说明 | |--------|------|------| | code | number | 状态码，0表示成功 | | msg | string | 返回消息 | | time | string | 查询时间 | | ip | string | 查询的IP地址 | | isp | string | 运营商 | | country | string | 国家 | | continent | string | 大洲 | | province | string | 省份 | | city | string | 城市 | | district | string | 区县 | | street | string | 街道 | | latitude | string | 纬度 | | longitude | string | 经度 | | full_address | string | 完整地址描述 | | api_info | object | API信息 | ## 返回示例 ### 成功示例 ```json { "code": 0, "msg": "查询成功", "time": "2026-05-25 04:30:00", "data": { "ip": "114.88.43.167", "isp": "电信", "country": "中国", "continent": "亚洲", "province": "上海市", "city": "上海市", "district": "浦东新区", "street": "陆家嘴街道", "latitude": "31.24", "longitude": "121.50", "full_address": "电信亚洲中国上海市上海市浦东新区陆家嘴街道(lat31.24/lon121.50)" }, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "api_platform": "https://api.xunjinlu.fun" } } ``` ### 失败示例 ```json { "code": 1001, "msg": "IP地址格式错误" } ``` ## 错误码 | 错误码 | 说明 | |--------|------| | 0 | 查询成功 | | 1001 | IP地址格式错误 | | 1002 | 接口访问密钥无效 | | 1003 | 查询次数超限 | | 1004 | 服务器内部错误 | | 1005 | IP地址未找到 | ## 调用示例 ### 浏览器直接访问 ``` https://api.xunjinlu.fun/api/ip/v2.php?key=YOUR_KEY&ip=114.88.43.167 ``` ### cURL ```bash curl "https://api.xunjinlu.fun/api/ip/v2.php?key=YOUR_KEY&ip=114.88.43.167" ``` ### Python ```python import requests url = "https://api.xunjinlu.fun/api/ip/v2.php" params = { "key": "YOUR_KEY", "ip": "114.88.43.167" } response = requests.get(url, params=params) print(response.json()) ``` ### PHP ```php "YOUR_KEY", "ip" => "114.88.43.167" ]; $context = stream_context_create([ "http" => [ "method" => "GET", "header" => "Content-Type: application/json\r\n", "content" => http_build_query($params) ] ]); $response = file_get_contents($url, false, $context); echo $response; ?> ``` ### HTML ```html

查询

```