接口调用文档
1. 接口地址
https://www.i5p.com/ip.php
3. 请求参数
| 参数名 |
类型 |
是否必填 |
说明 |
| ip |
字符串 |
否 |
需查询的IP地址（如：218.18.228.178）。
不填则默认返回当前请求用户的IP信息。 |
4. 示例请求
示例1：查询指定IP（218.18.228.178）
https://www.i5p.com/ip.php?ip=218.18.228.178
示例2：查询当前用户IP（不填ip参数）
https://www.i5p.com/ip.php
5. 返回格式
JSON格式，包含以下字段：
{
"ret": 200, // 状态码（200为成功）
"msg": "success", // 状态描述
"data": {
"ip": "218.18.228.178", // IP地址
"long_ip": "3658671282", // IP长整型（用于计算）
"isp": "电信", // 运营商
"area": "华南", // 区域（如：华北、华南）
"region_id": "440000", // 地区/省份代码
"region": "广东", // 地区/省份
"city_id": "440300", // 城市代码
"city": "深圳", // 城市
"country_id": "CN", // 国家代码
"country": "中国" // 国家
},
"log_id": "5091c8e1586d40f0bf724abcbdd7f26c" // 本次查询唯一日志ID
}
6. 字段说明
| 字段名 |
说明 |
| ret |
状态码：200表示成功，其他为错误码 |
| msg |
状态描述：成功时为"success"，错误时为具体原因 |
| data.ip |
查询的IP地址 |
| data.long_ip |
IP地址转换的长整型数值（用于IP范围计算） |
| data.isp |
网络运营商（如：电信、联通、移动） |
| data.area |
大区（如：华北、华东、华南） |
| data.region_id |
省份/地区的行政代码（如：440000代表广东省） |
| data.region |
省份/地区名称（如：广东、北京） |
| data.city_id |
城市的行政代码（如：440300代表深圳市） |
| data.city |
城市名称（如：深圳、上海） |
| data.country_id |
国家代码（如：CN代表中国） |
| data.country |
国家名称（如：中国、美国） |
| log_id |
本次查询的唯一标识，用于问题排查 |
7. 错误码说明
| 错误码（ret） |
说明 |
| 40001 |
无效的IP地址（IP格式错误） |
| 40002 |
IP地址转换失败（非有效IPv4地址） |
| 500 |
服务器内部错误（如数据库连接失败、接口调用异常） |
| 其他 |
具体错误信息见msg字段 |
8. 调用示例（AJAX）
JavaScript示例（使用fetch API）：
// 查询指定IP
fetch('https://www.i5p.com/ip.php?ip=218.18.228.178')
.then(response => response.json())
.then(data => {
if (data.ret === 200) {
console.log('查询成功：', data.data);
} else {
console.log('查询失败：', data.msg);
}
})
.catch(error => console.error('请求异常：', error));
// 查询当前用户IP
fetch('https://www.i5p.com/ip.php')
.then(response => response.json())
.then(data => console.log('当前IP信息：', data.data))
.catch(error => console.error('请求异常：', error));