AbuseIPDB：IP信誉查询API

接入教程

1. 访问 AbuseIPDB 官网注册账户获取 API 密钥。
2. 查看文档了解端点调用方式，如检查 IP 信誉。
3. 使用 HTTP 请求或 SDK 集成 API 到您的应用中。
4. 测试查询功能，验证返回的信誉数据。
5. 根据结果配置安全策略，如阻止恶意 IP。

Python 查询IP信誉示例

python

import requests

url = 'https://api.abuseipdb.com/api/v2/check'
headers = {
    'Accept': 'application/json',
    'Key': 'YOUR_API_KEY'
}
params = {
    'ipAddress': '8.8.8.8',
    'maxAgeInDays': 90
}

response = requests.get(url, headers=headers, params=params)
data = response.json()
print(f'IP信誉分数: {data["data"]["abuseConfidenceScore"]}')
print(f'总报告数: {data["data"]["totalReports"]}')

PHP 检查域名信誉示例

php

<?php

$url = 'https://api.abuseipdb.com/api/v2/check-block';
$headers = [
    'Accept: application/json',
    'Key: YOUR_API_KEY'
];
$data = [
    'network' => 'example.com/24',
    'maxAgeInDays' => 30
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));

$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result && isset($result['data'])) {
    echo '网络信誉检查完成，共发现 ' . count($result['data']) . ' 个可疑IP';
}

curl_close($ch);
?>

JavaScript 报告恶意URL示例

javascript

const fetch = require('node-fetch');

async function reportUrl() {
    const url = 'https://api.abuseipdb.com/api/v2/report';
    const headers = {
        'Accept': 'application/json',
        'Key': 'YOUR_API_KEY',
        'Content-Type': 'application/x-www-form-urlencoded'
    };
    
    const body = new URLSearchParams({
        'url': 'http://malicious-example.com',
        'categories': '18,22',
        'comment': '钓鱼网站检测'
    });

    try {
        const response = await fetch(url, {
            method: 'POST',
            headers: headers,
            body: body
        });
        
        const data = await response.json();
        console.log('报告提交成功:', data.data.reportId);
    } catch (error) {
        console.error('报告提交失败:', error);
    }
}

reportUrl();

常见问题

AbuseIPDB API 的主要用途是什么？

AbuseIPDB API 主要用于查询 IP 地址、域名和 URL 的信誉评分，检测恶意活动。它可以识别垃圾邮件发送者、黑客攻击源、恶意软件分发点等网络威胁，帮助用户构建安全防护系统。

如何获取 AbuseIPDB API 密钥？

您需要访问 AbuseIPDB 官方网站注册账户，然后在控制面板中生成 API 密钥。免费版本有每日查询次数限制，付费计划提供更高的请求配额和额外功能。

API 请求有哪些常见限制？

免费版通常限制每日请求次数（如1000次/天），所有版本都有速率限制（如每分钟请求数）。建议在代码中添加适当的错误处理和重试逻辑，避免因超限导致服务中断。