IP 地址查询 API 接口文档

本文档提供了 IP 地址查询 API 的详细集成指南，旨在通过 HTTP GET 请求提供精准的 IPv4 和 IPv6 地址地理位置及相关网络信息解析服务。

1. 接口说明

基地址：/

1.1 IP 地理位置查询

• 请求路径：/api/ip
• 请求方法：GET
• 功能描述：根据提供的 IP 地址查询并返回详细的地理位置、ISP 及相关元数据。

请求参数：

1.2 当前访问者查询

使用 GET /api/ip/self 查询当前访问者的 IP 和归属信息，无需传入 ip。可通过 lang 指定语言，返回字段与 IP 地理位置查询一致。

curl "/api/ip/self"

2. 响应数据字典

成功调用后，API 将返回 JSON 格式的数据对象。以下为各字段的详细说明：

3. 请求与响应示例

为提升阅读效率，以下精简并整合了最具代表性的调用场景。

3.1 综合查询（IPv4 结合多语言参数）

通过附加 lang 参数获取指定语言（如英文）的定位信息。

请求指令：

curl "/api/ip?ip=84.245.9.227&lang=en"

响应报文：

{
  "ip": "84.245.9.227",
  "ip_version": "IPv4",
  "continent": "Europe",
  "country": "Netherlands",
  "province": "Flevoland",
  "city": "Almere Stad",
  "district": "",
  "isp": "Cambrium",
  "country_code": "",
  "longitude": "52.385800",
  "latitude": "5.221500",
  "admin_code": "",
  "area_code": "",
  "zip_code": "1316",
  "time_zone": "Europe/Amsterdam",
  "currency": "EUR",
  "elevation": "",
  "weather_station": "",
  "language": "en"
}

3.2 IPv6 协议查询

查询 IPv6 格式地址，返回结果将包含专属的 country_code 字段。

请求指令：

curl "/api/ip?ip=240e:3b7:3272:d8d0:db09:c067:8d59:539e"

响应报文：

{
  "ip": "240e:3b7:3272:d8d0:db09:c067:8d59:539e",
  "ip_version": "IPv6",
  "continent": "Asia",
  "country": "中国",
  "province": "广东省",
  "city": "深圳市",
  "district": "",
  "isp": "电信",
  "country_code": "CN",
  "longitude": "",
  "latitude": "",
  "admin_code": "",
  "area_code": "",
  "zip_code": "",
  "time_zone": "",
  "currency": "",
  "elevation": "",
  "weather_station": ""
}

4. 异常与错误处理

当 API 调用遭遇异常时，将返回相应的 HTTP 状态码及错误信息描述，以便快速定位问题。