历史上的今天
历史上的今天事件列表，支持文本和 JSON 两种格式响应。
GETJSON / 文本已发布版本 1.0
快速接入
QUICK START- 01查看参数说明选择请求方式与取值
- 02查看实际响应
- 03复制代码开始接入按你的开发语言选择
示例请求
每个 IP 每分钟 120 次；图片接口可能另有较低额度。限流时请按 Retry-After 等待。
请求参数
| 参数 | 类型 / 必填 | 示例 / 默认 | 说明 / 取值 |
|---|---|---|---|
type | string | json默认：text | 指定返回数据text/json 取值：json,text |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
data | array | 历史事件数组 |
notice | string | 系统提示信息 |
data.index | int | 事件序号（1-15） |
data.year | string | 年份 |
data.event | string | 事件描述 |
返回示例
文本格式响应示例：
1：前209年-陈胜、吴广在大泽乡起义
2：前43年-古罗马政治家西塞罗逝世
...
15：1999年-巴拿马收回运河主权
注意：由于内容过长，只显示15个历史事件
JSON格式响应示例：
{
"data": [
{
"index": 1,
"year": "前209年",
"event": "陈胜、吴广在大泽乡起义"
},
{
"index": 2,
"year": "前43年",
"event": "古罗马政治家西塞罗逝世"
},
// ...其他数据
],
"notice": "注意：由于内容过长，只显示15个历史事件"
}错误说明
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求参数无效 |
| 405 | 请求方法不支持 |
| 413 | 请求内容过大 |
| 429 | 请求过于频繁 |
| 502 | 上游服务不可用 |
| 503 | 接口维护中 |
400：检查参数；429：按 Retry-After 等待；503：维护中；502：上游暂不可用，可稍后重试或反馈。
响应结果
RESPONSE点击发送请求后查看响应。
接入代码
INTEGRATION代码根据当前请求方式和参数生成。先到在线调试填入参数，再复制到自己的程序。
站长补充的 PHP 示例
<?php
$url = 'https://api.keguan.org.cn/api/lsjt/api.php?type=json';
$ch = curl_init($url);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 5, CURLOPT_TIMEOUT => 30, CURLOPT_SSL_VERIFYPEER => true, CURLOPT_SSL_VERIFYHOST => 2]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$contentType = curl_getinfo($ch, CURLINFO_CONTENT_TYPE);
if ($response === false) { throw new RuntimeException(curl_error($ch)); }
curl_close($ch);
if ($status >= 400) { throw new RuntimeException('HTTP ' . $status . ': ' . $response); }
header('Content-Type: ' . ($contentType ?: 'application/octet-stream'));
echo $response;