IP258 API 接口对接文档

在线调试面板（测试接口返回效果）

重要说明

一、接口基础地址

接口路径：https://ip258.cn/api.php

二、接口1：查询指定IP信息（IPv4/IPv6通用）

功能：传入IP地址，返回该IP归属地、运营商、城市、区域等完整信息

请求方式：GET

请求参数：ip 字符串，必填，无key参数

curl https://ip258.cn/api.php?ip=1.1.1.1

三、接口2：获取访问者本机公网IP

功能：无需传IP，自动获取当前访客出口公网IP，零参数鉴权

请求方式：GET

请求参数：myip=1

curl https://ip258.cn/api.php?myip=1

四、PHP对接示例代码（PHP7.3兼容）

<?php
// PHP请求接口示例，无需key
$ip = "1.1.1.1";
$apiUrl = "https://ip258.cn/api.php?ip=".urlencode($ip);
$json = file_get_contents($apiUrl);
$data = json_decode($json,true);
print_r($data);
?>

五、JavaScript网页对接示例

// JS fetch请求示例，不带密钥
fetch('https://ip258.cn/api.php?ip=1.1.1.1')
.then(res=>res.json())
.then(ret=>{
    console.log(ret);
})

六、返回数据格式说明

统一JSON格式，code=200为成功，其他状态码代表查询失败

• code：状态码，200=成功，400=参数错误，404=IP格式非法
• msg：状态文字说明
• data：IP详细数据对象（国家、省份、城市、运营商、IP类型等）