API 文档

一个接口拿到完整的 IP 地理位置与运营商信息,返回标准 JSON。

接口地址

无需鉴权,支持跨域(CORS 全开放)。直接以真实文件名访问:

GET  https://ipwcc.fun/ipcc.php            # 查询访客自身 IP
GET  https://ipwcc.fun/ipcc.php?ip=1.2.3.4 # 查询指定 IP

请求参数

参数位置必填说明
ipQuery要查询的 IP 地址。省略时自动取访客真实 IP。

返回字段

字段类型说明
codestring状态:SuccessError
ipstring查询的 IP 地址
data.countrystring国家
data.provstring省份
data.citystring城市
data.districtstring区/县
data.ispstring运营商(自动中文化)

响应示例

成功

{
  "code": "Success",
  "ip": "1.2.3.4",
  "data": {
    "country": "中国",
    "prov": "广东省",
    "city": "深圳市",
    "district": "南山区",
    "isp": "中国电信"
  }
}

失败

{
  "code": "Error",
  "message": "无法获取位置信息",
  "ip": "1.2.3.4",
  "data": {
    "country": "未知",
    "prov": "未知",
    "city": "未知",
    "district": "未知",
    "isp": "未知"
  }
}

在线试一试

输入一个 IP(留空则查询你自己的 IP),实时请求接口查看返回。