接口概述

本接口提供IP地址/域名的归属地查询服务，支持IPv4地址查询、域名自动解析后查询，返回包含国家、省份、城市、运营商等详细信息的JSON格式数据。
接口优先级：主接口 → 备用接口1 → 备用接口2 → 备用接口3 → 备用接口4，不同接口返回字段完整性不同，空值/未知字段会自动过滤。

接口参数说明

请求参数

返回参数（JSON）

状态码说明

调用示例

1. 直接浏览器访问（测试用）

{
  "code": 200,
  "msg": "查询成功",
  "data": {
    "input": "123.161.169.10",
    "ip": "123.161.169.10",
    "country": "中国",
    "province": "河南",
    "city": "驻马店驿城区",
    "isp": "中国电信",
    "continent": "亚洲",
    "zipcode": "463900",
    "areacode": "CN",
    "adcode": "411702"
  }
}

{
    "code": 401,
    "msg": "未授权：缺少有效的API授权码（key参数），由 4759.cn 提供服务",
    "data": null
}

2. PHP调用示例

<?php
/**
 * PHP调用IP查询API示例
 */

// 接口配置
$apiUrl = 'http://ping.4759.cn/api/ip.php';
$apiKey = 'key_1234567890abcdef1234567890abcdef_9876543210'; // 你的授权码
$target = 'www.baidu.com'; // 要查询的IP/域名

// 拼接请求URL（新增key参数）
$requestUrl = $apiUrl . '?key=' . urlencode($apiKey) . '&ip=' . urlencode($target);

// 初始化curl
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => $requestUrl,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_SSL_VERIFYHOST => false
]);

// 发起请求并处理结果
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if ($result['code'] == 200) {
    echo "查询成功：" . json_encode($result['data'], JSON_UNESCAPED_UNICODE);
} else {
    echo "查询失败：{$result['msg']}（状态码：{$result['code']}）";
}
?>

3. JavaScript/AJAX调用示例

<script>
/**
 * 前端调用IP查询API示例
 */
const apiKey = 'key_1234567890abcdef1234567890abcdef_9876543210'; // 你的授权码
const apiUrl = 'http://ping.4759.cn/api/ip.php';
const target = '8.8.8.8';

// 拼接请求URL（新增key参数）
const requestUrl = `${apiUrl}?key=${encodeURIComponent(apiKey)}&ip=${encodeURIComponent(target)}`;

// 发起请求
fetch(requestUrl)
    .then(response => response.json())
    .then(result => {
        if (result.code === 200) {
            console.log('查询结果：', result.data);
        } else {
            console.error('查询失败：', result.msg);
        }
    })
    .catch(error => {
        console.error('请求失败：', error);
    });
</script>

在线测试

注意事项

常见问题解答