URLhaus恶意网址查询API

接入教程

1. 访问官网注册获取API密钥
2. 查阅文档了解查询端点与参数格式
3. 使用GET/POST请求调用恶意网址查询接口
4. 通过下载接口获取关联的恶意软件样本
5. 解析JSON响应数据并集成到安全系统中
6. 定期更新数据以保持威胁情报时效性

使用Python查询恶意URL

python

import requests

url = "https://urlhaus-api.abuse.ch/v1/urls/recent/"
headers = {"API-Key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)
if response.status_code ==致以:
    data = response.json()
    for entry in data.get('urls', []):
        print(f"URL: {entry.get('url')}, Threat: {entry.get('threat')}")
else:
    print(f"Error: {response.status_code}")

使用PHP批量查询恶意软件样本

php

<?php
$apiUrl = "https://urlhaus-api.abuse.ch/v1/payloads/recent/";
$apiKey = "YOUR_API_KEY";

$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["API-Key: $apiKey"]);

$response = curl_exec($ch);
if ($response === false) {
    echo "CURL Error: " . curl_error($ch);
} else {
    $data = json_decode($response, true);
    foreach ($data['payloads'] as $payload) {
        echo "SHA256: " . $payload['sha256_hash'] . "\n";
    }
}
curl_close($ch);
?>

使用JavaScript获取URL威胁信息

javascript

const apiUrl = "https://urlhaus-api.abuse.ch/v1/url/"
const apiKey = "YOUR_API_KEY"

async function checkUrl(urlToCheck) {
    const response = await fetch(apiUrl, {
        method: 'POST',
        headers: {
            'Content-Type': 'application/x-www-form-urlencoded',
            'API-Key': apiKey
        },
        body: `url=${encodeURIComponent(urlToCheck)}`
    });
    
    if (response.ok) {
        const data = await response.json();
        console.log(`URL Status: ${data.query_status}`);
        console.log(`Threat: ${data.threat}`);
    } else {
        console.error(`HTTP Error: ${response.status}`);
    }
}

// Example usage
checkUrl("http://example.com/suspicious");

常见问题

URLhaus API是否需要API密钥？

是的，大部分端点需要有效的API密钥进行身份验证。您可以在官方网站注册账户获取API密钥。某些公开端点（如最近提交列表）可能无需密钥，但建议始终使用密钥以确保稳定访问。

API调用频率是否有限制？

是的，API设有速率限制以防止滥用。免费层级通常为每分钟60次请求，具体限制可能根据账户类型和端点而异。建议在代码中实现适当的延迟和错误处理。

如何下载恶意软件样本文件？

通过/payloads/端点获取样本信息后，可使用提供的下载链接获取文件。下载链接通常需要API密钥授权，且样本为加密压缩包（如ZIP格式），解压密码会在响应中提供。请确保在安全隔离环境中处理样本。