IPUU API 文档

本文档介绍IPUU项目提供的API接口,包括IP地址查询、地理位置获取等功能。

API 概览

融合MMDB和QQWry数据的IP查询接口。

如果要使用API,需要先申请api_token 。

API 详细说明

请求地址

BaseUrl: https://api.ipuu.cn/v1

请求参数

参数 类型 必填 描述
api_token string 认证密钥
ip string 要查询的IP地址,不填则为本地IP

请求示例

GET https://api.ipuu.cn/v1?token=<你的api_token>&ip=<你要查询的IP>

响应格式

{ "success": true, "message": "查询成功", "data": { "ip": "120.225.8.166", "country": { "name": "中国", "code": "CN" }, "city": "济南市", "subdivision": { "name": "山东", "code": "SD" }, "location": { "latitude": 36.6683, "longitude": 116.9972, "timezone": "Asia\/Shanghai" }, "postal_code": "" } }

错误代码

状态码 含义 通俗解释 常见场景
200 Success (成功) 请求成功 - 正常调用
401 Unauthorized(未授权) “你没有登录”
请求需要用户身份认证,但客户端未提供认证信息或认证失败。
- 未登录时访问需要登录的页面
- Token 过期或无效
- 未提供 api_token
402 Payment Required(需要付款) “请先付费”
账户余额不足,或者使用了付费项目
- 需要付费订阅的 API
- 试用期结束的服务
- 微支付场景
403 Forbidden(禁止访问) “你没有权限”
服务器理解请求,但拒绝执行。与 401 不同的是,即使用户登录也无法访问。
- 访问管理员页面(普通用户)
- IP 被列入黑名单
- 文件权限不足

使用示例

PHP 示例 (推荐)

// 使用curl请求API function getIPInfo($ip) { $url = "https://api.ipuu.cn/v1?token=YOUR_API_TOKEN&ip=" . urlencode($ip); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_TIMEOUT, 10); $response = curl_exec($ch); curl_close($ch); return json_decode($response, true); } // 示例调用 $ipInfo = getIPInfo('223.5.5.5'); if ($ipInfo['success']) { echo "IP: " . $ipInfo['data']['ip'] . "\n"; echo "国家: " . $ipInfo['data']['country']['name'] . "\n"; echo "城市: " . $ipInfo['data']['city'] . "\n"; }

Python 示例

import requests # 使用requests库请求API def get_ip_info(ip): url = f"https://api.ipuu.cn/v1?token=YOUR_API_TOKEN&ip={ip}" try: response = requests.get(url, timeout=10) data = response.json() if data['success']: print(f"IP: {data['data']['ip']}") print(f"国家: {data['data']['country']['name']}") print(f"城市: {data['data']['city']}") return data except Exception as e: print(f"Error: {e}") # 示例调用 get_ip_info('223.5.5.5')

JavaScript 示例 (已禁用,暴露API_KEY风险)

// 使用fetch API请求 async function getIPInfo(ip) { try { const response = await fetch(`https://api.ipuu.cn/v1?token=YOUR_API_TOKEN&ip=${encodeURIComponent(ip)}`); const data = await response.json(); if (data.success) { console.log(`IP: ${data.data.ip}`); console.log(`国家: ${data.data.country.name}`); console.log(`城市: ${data.data.city}`); } return data; } catch (error) { console.error('Error:', error); } } // 示例调用 getIPInfo('223.5.5.5');
©2005-2026 艾普(ipuu.cn) IP查询 中国U网(美国服务器租用)旗下网站