IP 信息查询

GET
https://api.xuewutheme.com/api/info/ip

IP信息查询，支持IPV4、IPV6地址

快速导航

接口状态

状态: 已上线
更新: 2025-12-17 00:00:00

接口概述

请求示例： https://api.xuewutheme.com/api/info/ip?apikey=用户开通的apikey&ip=123.128.0.0

IP信息查询，支持IPV4、IPV6地址

请求参数

参数名 类型 必填 描述
apikey string 整数 string

用户开通的apikey
ip string 整数 string

IP地址

响应参数

成功响应

状态码: 200 OK
格式: json
参数名 类型 描述
code integer integer

返回的状态码
data object object

返回的数据/数据对象
msg string string

返回的消息
time string string

请求时间
data.city string string

城市
data.country string string

国家
data.district string string

区县
data.isp string string

互联网服务提供商（ISP）
data.lat string string

纬度
data.lng string string

经度
data.province string string

省份

响应示例

JSON 
{
    "code": 200,
    "data": {
        "city": "泰安市",
        "country": "中国",
        "district": "泰山区",
        "isp": "联通",
        "lat": "36.194968",
        "lng": "117.129063",
        "province": "山东省"
    },
    "msg": "请求成功！",
    "time": "2024-02-27 21:07:48"
}

请求示例

cURL

Bash 
curl -X GET \
  "https://api.example.com/v1/users/12345" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json"

Python

Python 
import requests

url = "https://api.example.com/v1/users/12345"
headers = {
    "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

JavaScript

JavaScript 
const response = await fetch(
  'https://api.example.com/v1/users/12345',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
      'Content-Type': 'application/json'
    }
  }
);

const data = await response.json();
console.log(data);

PHP

PHP 
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://api.example.com/v1/users/12345");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");

$headers = array();
$headers[] = "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...";
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

curl_close($ch);

错误码

状态码 描述
100 您的apikey值为空！
101 您的apikey值不存在！
103 当前接口为实名认证后可用，请您先进行实名！
104 请求频率超限！
105 接口不存在或已下线！
106 您的余额不足，请及时充值！
107 您当前的接口免费使用次数已用完，请明日再来！
109 您的账号已被封禁，不可使用任何接口！
110 接口维护中，请稍后再试！
111 请求参数不完整，请检查后再次访问！

错误响应示例

JSON 
{
  "code": 1001,
  "message": "用户不存在",
  "data": null
}