颱風說開放 API 文檔

颱風說提供免費的公開只讀 API，可用於查詢即時颱風與歷史颱風資料。所有介面返回 JSON，支援跨域(CORS)。請合理使用，資料僅供參考，請以官方發佈爲準。

即時資料

介面	說明
`GET /api/typhoons`	當前活躍颱風列表(完整路徑點/風圈/多機構預報)
`GET /api/typhoons/{code}`	單個颱風詳情，如 `/api/typhoons/202609`(活躍→歸檔→上游即時三級回退)

歷史資料(1945年至今)

介面	說明
`GET /api/history/years`	已歸檔年份統計
`GET /api/history/{year}`	某年全部颱風概要列表
`GET /api/history/search/{keyword}`	按名稱/編號搜尋颱風(最多50條)
`GET /api/history/today`	歷史上的今天知名颱風
`GET /api/seo/news`	最新颱風快訊(AI生成, 可加 ?code= 過濾)

資料結構示例

GET /api/typhoons/202609 返回:

欄位	說明
`typhoon.code`	颱風編號, 如 202609
`typhoon.name / enname`	中文名 / 英文名
`typhoon.points[]`	路徑點數組: time/lat/lng/strong/power/speed/pressure/moveDir/radius7/radius10/radius12
`typhoon.forecasts`	多機構預報路徑: 中國/日本/美國/中國香港/中國台灣等
`typhoon.land[]`	登陸資訊

APP / 客戶端 API (v1, 推薦)

面向安卓/iOS/鴻蒙等客戶端的穩定契約介面，統一返回信封結構 {"code":0,"msg":"ok","data":...,"ts":1710000000000}(code=0 成功, 非0 爲業務錯誤碼)，支援完整 CORS 預檢(OPTIONS)，列表介面統一分頁參數 ?page=&size=(size 上限 50)。

介面	說明
`GET /api/v1/bootstrap`	APP 啓動聚合介面: 站點配置+公告+活躍颱風摘要+今日晨報+版本資訊(一次請求完成冷啓動)
`GET /api/v1/version?platform=android\|ios\|harmony`	版本檢查/強制更新(latest/min/url/notes)
`GET /api/v1/typhoons` / `/api/v1/typhoons/{code}`	活躍颱風列表 / 單颱風詳情(含歷史歸檔回退)
`GET /api/v1/flash` / `/api/v1/flash/{id}`	颱風快訊分頁列表 / 詳情
`GET /api/v1/news` / `/api/v1/news/{slug}`	颱風新聞日報分頁列表 / 詳情(含來源列表)
`GET /api/v1/knowledge` / `/api/v1/knowledge/{slug}`	颱風百科列表 / 文章詳情(含 Markdown 正文)
`GET /api/v1/history/years` / `/api/v1/history/{year}` / `/api/v1/history/search/{kw}`	歷史颱風庫(1945年至今)

錯誤碼約定: 40001 參數錯誤 · 40401 資源不存在 · 40400 未知端點 · 50000 服務端錯誤。所有響應攜帶 X-Api-Version: v1 頭。網頁端原有 /api/* 介面保持不變。

資料來源：浙江省水利廳、中央氣象台。如引用本站資料，請註明來源"颱風說 taifengshuo.com"。