本接口提供IPv4 + IPv6 双栈 IP地址/域名归属地查询服务，支持域名自动解析，自动识别IP类型，返回国家、省份、城市、区县、运营商、经纬度、大洲等完整信息。
| 项目 | 说明 |
|---|---|
| 接口地址 | https://ping.4759.cn/api/ip.php |
| 请求方式 | GET |
| 返回格式 | JSON（UTF-8编码） |
| IP支持 | IPv4 + IPv6 双栈自动识别 |
| 跨域支持 | 支持（允许所有域名调用） |
| 调用限制 | 按KEY等级限流 + 单IP防刷 |
| 授权要求 | 必须携带有效的key参数 |
| 特色 | IP不填自动获取访问者IP，域名自动解析，字段自动补全 |
| 参数名 | 是否必填 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
| key | 是 | 字符串 | API授权码 | 内置测试授权码 |
| ip | 否 | 字符串 | 不填则自动获取访问者IP，支持IPv4/IPv6/域名 | 1.1.1.1 / 240a::1 / baidu.com |
| 层级 | 参数名 | 类型 | 说明 |
|---|---|---|---|
| 顶级 | code | 整数 | 200=成功,400=参数错误,401=未授权,429=频率超限,500=异常 |
| 顶级 | msg | 字符串 | 状态描述 |
| data | input | 字符串 | 用户输入内容 |
| data | ip | 字符串 | 最终查询IP |
| data | ip_type | 字符串 | IPv4 / IPv6 |
| data | country | 字符串 | 国家 |
| data | province | 字符串 | 省份 |
| data | city | 字符串 | 城市 |
| data | district | 字符串 | 区县 |
| data | isp | 字符串 | 运营商 |
| data | big_area | 字符串 | 大区（华北/华东/华南等） |
| data | continent | 字符串 | 大洲（亚洲/欧洲等） |
| data | lng | 字符串 | 经度 |
| data | lat | 字符串 | 纬度 |
| data | country_code | 字符串 | 国家代码 |
| 状态码 | 说明 |
|---|---|
| 200 | 查询成功 |
| 400 | IP不合法 |
| 401 | 缺少授权码/无效KEY |
| 429 | 请求频率过高，请1分钟后重试 |
| 500 | 接口查询失败 |
带授权码调用 IPv6
https://ping.4759.cn/api/ip.php?key=内置测试授权码&ip=240a:42cd:5c00:e03::1
https://ping.4759.cn/api/ip.php?key=内置测试授权码&ip=1.1.1.1
<?php
$apiKey = "你的授权码";
$ip = "240a:42cd:5c00:e03::1";
$url = "https://ping.4759.cn/api/ip.php?key=$apiKey&ip=$ip";
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_SSL_VERIFYPEER => false,
]);
$res = curl_exec($ch);
curl_close($ch);
echo $res;
?>