← API.MAO.MS 首頁簡體 · 繁體 · EN

歷史上的今天 API

免費、無需金鑰。查詢任意日期在歷史上發生的大事、出生與逝世名人。

資料說明

繁體版為全量版:覆蓋全年 366 天(含 2 月 29 日),每天約 170 條(大事記 / 出生 / 逝世),公元前年份以負數表示,條目不附簡介。介面傳 lang=hant 用繁體通用版,傳 lang=tw 為台灣正體、lang=hk 為香港繁體,個別用詞略有差異。注意:經本站正式域名呼叫時,中國大陸地區 IP 請求繁體或英文版將回覆「不支援」,大陸地區僅提供簡體中文版。

介面文件

基礎路徑 /v1/history,全部為 GET 請求,返回 {code, message, data}。

GET /v1/history/today 今天

引數預設說明
tzAsia/Shanghai按哪個時區算「今天」,IANA 時區名
type全部可選 event / birth / death,只返回一類
請求:/v1/history/today
返回(節選):{"code":0,"message":"ok","data":{"month":11,"day":12,"date":"2026-11-12","counts":{"event":55,"birth":109,"death":45,"total":209},"events":[{"year":725,"text":"唐朝天文學家僧一行與梁令瓚研製成功水運渾天儀。"},…]}}

GET /v1/history/day 指定日期

引數預設說明
month必填月份 1–12
day必填日期,須在該月範圍內(2 月按 29 天)
type全部可選 event / birth / death,只返回一類
請求:/v1/history/day?month=11&day=12&type=birth
返回(節選):{"code":0,"message":"ok","data":{"month":11,"day":12,"counts":{"event":55,"birth":109,"death":45,"total":209},"births":[{"year":1524,"text":"迭戈·德·蘭達,西班牙方濟各會傳教士(1579年逝世)"},{"year":1528,"text":"戚繼光,明朝抗倭將領、軍事家(1588年逝世)"},…]}}

呼叫統計

歷史上的今天介面累計被呼叫 22 次 · 今日 0 次。全部介面統計見 呼叫統計頁。

介面路徑今日累計
今日/v1/history/today06
指定日期/v1/history/day011
介面索引/v1/history05

線上測試

月 日
點「今天」或選個日期查詢,這裡會顯示真實資料。