LOLKU API

主题

历史上的今天 ​

按日期查询历史上的今天发生的重大事件，数据来源于聚合数据 OpenAPI，支持手动刷新拉取。

内置「当日数据整体跳过」+「单条事件双重查重」两层幂等保护。

查询事件列表 ​

按日期查询历史上的今天发生的重大事件，支持按 day（月-日，跨年份）或 date（具体年月日）查询。

  • 方法: GET
  • 路径: /api/web/todayOnhistory

请求参数 (Query) ​

参数类型必填说明
daystring否月-日，如 08-07 / 8-7，默认取当天
datestring否完整年月日，如 2026-08-07，优先级高于 day
pageint否页码，默认 1
sizeint否每页条数，默认 50，最大 500

去重策略

存储时使用双查重机制（e_id 唯一索引 + title+day 名称查重），确保不会重复。

请求示例 ​

bash
GET /api/web/todayOnhistory?day=08-07&page=1&size=20
GET在线测试

查询单条事件详情 ​

  • 方法: GET
  • 路径: /api/web/todayOnhistory/:id

路径参数 ​

参数类型必填说明
idstring是事件 ID（自增主键）
GET在线测试

手动拉取 / 刷新数据 ​

从聚合数据 OpenAPI 拉取指定日期的事件列表，并逐条拉取详情保存到数据库。

  • 方法: POST
  • 路径: /api/web/todayOnhistory/refresh
  • Content-Type: application/json

请求参数 (Body JSON) ​

参数类型必填说明
datestring否格式 M/D，如 8/7，默认当天
forcebool/string否true 忽略当日已存判断强制拉取，默认 false

请求示例 ​

bash
POST /api/web/todayOnhistory/refresh
Content-Type: application/json

{ "date": "8/7", "force": false }
POST在线测试

幂等说明 ​

  1. 先检查 WHERE day = ? 是否已有数据，有则直接跳过返回。
  2. 单条事件保存时，先查 e_id 唯一索引，再查 title+day 名称查重。
  3. 启动脚本 / 定时任务同样遵循上述规则。