历史事件查询

本接口为历史事件查询接口，支持按照不同类型、月份和日期查询历史事件。

接口状态:正常

总调用:1,013

添加时间:2024-09-07

更新时间:2025-11-01

请求信息

请求地址：

https://api.hh2xx.cn/API/history.php

示例地址：

https://api.hh2xx.cn/API/history?type=1&month=10&day=1&page_size=20&page_number=1

请求参数

参数名	类型	必填	说明
type	string	否	事件类型。可选值为：1（大事记）、2（出生）、3（逝世）。如果不填该参数，则返回所有类型的历史事件。
month	string	是	事件月份。可选值为：1~12。
day	string	是	事件日期。可选值为：1~31。
keyword	string	否	关键词。用于对事件描述进行模糊查询。
page_size	string	否	每页返回的历史事件数量，默认值为20。最大值为100。
page_number	string	否	返回的历史事件页码，默认值为1。

状态码说明

状态码	说明
200	请求成功，服务器已成功处理了请求。
403	服务器拒绝请求。这可能是由于缺少必要的认证凭据（如API密钥）或权限不足。
404	请求的资源未找到。请检查您的请求地址是否正确。
429	请求过于频繁。您已超出速率限制，请稍后再试。
500	服务器内部错误。服务器在执行请求时遇到了问题。

在线测试

此处将显示接口返回结果...

调用示例

<?php
$url = 'https://api.hh2xx.cn/API/history.php';
$params = ['type' => 'YOUR_VALUE', 'month' => 'YOUR_VALUE', 'day' => 'YOUR_VALUE', 'keyword' => 'YOUR_VALUE', 'page_size' => 'YOUR_VALUE', 'page_number' => 'YOUR_VALUE', ];
$url .= '?' . http_build_query($params);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

import requests

url = "https://api.hh2xx.cn/API/history.php"
params = {
    'type': 'YOUR_VALUE',
    'month': 'YOUR_VALUE',
    'day': 'YOUR_VALUE',
    'keyword': 'YOUR_VALUE',
    'page_size': 'YOUR_VALUE',
    'page_number': 'YOUR_VALUE',
}
response = requests.get(url, params=params)
print(response.text)

const url = new URL('https://api.hh2xx.cn/API/history.php');
const params = {
    'type': 'YOUR_VALUE',
    'month': 'YOUR_VALUE',
    'day': 'YOUR_VALUE',
    'keyword': 'YOUR_VALUE',
    'page_size': 'YOUR_VALUE',
    'page_number': 'YOUR_VALUE',
};
Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));

fetch(url)
    .then(response => response.text())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));