IP 归属地查询 API
免费 IP 定位接口

接口使用说明

本服务提供 RESTful HTTP API，所有接口均返回 JSON 格式数据。支持 IPv4/IPv6 地址查询。 本机 IP 查询会自动识别公网 IP。

1. 查询指定 IP

GET /api/iploc/ip?ip=114.114.114.114

响应示例：

{
  "code": 0,
  "data": {
    "ip": "114.114.114.114",
    "country": "中国",
    "province": "江苏",
    "city": "南京",
    "isp": "114DNS",
    "latitude": "32.041544",
    "longitude": "118.767413"
  }
}

2. 查询本机公网 IP

GET /api/iploc/ip

响应示例（内网IP自动获取公网IP）：

{
  "code": 0,
  "data": {
    "ip": "59.46.153.246",
    "country": "中国",
    "province": "辽宁",
    "city": "大连",
    "isp": "中国电信",
    "latitude": "39.1004",
    "longitude": "121.71893",
    "original_ip": "::1"
  }
}

3. 查询指定 IP（RESTful 风格）

GET /api/iploc/ip/114.114.114.114

等价于 GET /api/iploc/ip?ip=114.114.114.114。

前端 JavaScript 调用示例

使用浏览器原生 fetch API 调用，无需 SDK：

// 查询指定 IP
async function lookupIp(ip) {
    const resp = await fetch(`/api/iploc/ip?ip=${encodeURIComponent(ip)}`);
    const json = await resp.json();
    if (json.code === 0) {
        return json.data;
    }
    throw new Error(json.message);
}

// 查询本机公网 IP
async function lookupSelf() {
    const resp = await fetch('/api/iploc/ip');
    const json = await resp.json();
    if (json.code === 0) {
        return json.data;
    }
    throw new Error(json.message);
}

// 使用示例
lookupIp('114.114.114.114').then(data => {
    console.log(`${data.ip} -> ${data.country} ${data.province} ${data.city}`);
});

lookupSelf().then(data => {
    console.log(`本机公网 IP: ${data.ip}, 位置: ${data.country} ${data.province} ${data.city}`);
});

响应字段说明