Public Read-only API

把校史放进你的应用。

按日期、月份、日期范围或历史年份查询 1424 条校史事件。接口无需鉴权，返回标题、完整正文、事件年份和原始来源链接。

查看今日数据开始调用

1,424校史事件

366完整日期覆盖

100单页最大条数

60/min默认单 IP 限流

Endpoints

接口入口

所有列表接口都支持分页、事件年份筛选与关键词搜索。日期统一使用 MM-DD。

GET /api/v1/history 按日期、月份、范围或年份查询查看

GET /api/v1/history/today 返回当前日期的校史事件查看

GET /api/v1/history/{id} 按稳定 ID 获取单条事件示例

GET /healthz 服务健康状态和数据版本查看

Quick start

示例会自动使用当前页面所在的域名。生产部署后无需修改地址。

Query contract

参数	说明	默认值
`date`	精确日期，格式 `MM-DD`	无
`month`	月份，范围 `1–12`	无
`start_date`	日期范围起点，包含该日	无
`end_date`	日期范围终点，包含该日	无
`event_year`	历史事件发生年份	无
`q`	搜索标题和正文，最多 100 字	无
`sort`	`date_asc`、`date_desc`、`year_asc`、`year_desc`	`date_asc`
`page`	页码，从 1 开始	`1`
`page_size`	每页条数，最大 100	`20`

date、month 和日期范围互斥；event_year 与 q 可以和任意日期条件组合。跨年范围示例：12-20 至 01-10。

Observability

仅保存各端点按小时聚合的请求数，不保存 IP、User-Agent 或完整请求记录。

30 天累计 —

最近 60 秒 —

正在处理 —

30 天限流响应 —

聚合数据默认保留 30 天；CDN 缓存命中不计入源站统计。每 5 秒刷新

端点	方法	近 1 小时	近 24 小时	30 天	限流	平均耗时
等待首次请求

Examples

直接打开链接即可查看 JSON 响应。

某一日期 /api/v1/history?date=11-01

某一月份 /api/v1/history?month=11&page_size=50

跨年范围 /api/v1/history?start_date=12-20&end_date=01-10

历史年份 /api/v1/history?event_year=1978

组合筛选 /api/v1/history?month=11&event_year=1978&q=印章

翻页 /api/v1/history?page=2&page_size=100