{"openapi":"3.1.0","info":{"title":"台风说 TyphoonSays 公开数据接口","version":"8.111.0","description":"西北太平洋台风实时路径、多机构预报、1945 年以来历史台风档案与全球热带气旋数据。只读、免密钥、允许跨域(CORS *)。实时数据为北京时间, 每 10 分钟更新; 引用请注明「台风说 taifengshuo.com」与数据时间。\n\nRead-only, no API key, CORS enabled. Times are Beijing time (UTC+8). Attribution: \"TyphoonSays (taifengshuo.com)\".","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"name":"台风说","url":"https://taifengshuo.com/contact","email":"contact@taifengshuo.com"},"termsOfService":"https://taifengshuo.com/cite"},"externalDocs":{"description":"API 文档(中文)","url":"https://taifengshuo.com/api-docs"},"servers":[{"url":"https://taifengshuo.com"}],"tags":[{"name":"live","description":"实时台风 / Live typhoons"},{"name":"history","description":"历史台风 / Archive"},{"name":"global","description":"全球热带气旋 / Global tropical cyclones"},{"name":"ai","description":"给大模型的摘要 / LLM-friendly"},{"name":"content","description":"快讯·日报·百科 / Content"}],"paths":{"/api/llm/summary":{"get":{"operationId":"llmSummary","tags":["ai"],"summary":"AI 友好实时摘要","description":"自然语言 summary + 结构化数据 + 数据时间(updated, 北京时间) + 全球气旋摘要。专为大模型引用设计。","parameters":[],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"不存在 / Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/typhoons":{"get":{"operationId":"listActiveTyphoons","tags":["live"],"summary":"当前活跃台风列表","description":"西北太平洋活跃台风: 完整路径点、风圈、各机构预报。","parameters":[],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"不存在 / Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/typhoons/{code}":{"get":{"operationId":"getTyphoon","tags":["live"],"summary":"单个台风详情","description":"活跃或历史台风, code 为 6 位编号(年份+序号)。","parameters":[{"name":"code","in":"path","required":true,"description":"台风编号 YYYYNN","schema":{"type":"string"},"example":"202411"}],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"不存在 / Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/history/years":{"get":{"operationId":"historyYears","tags":["history"],"summary":"历史年份统计","description":"已归档年份与每年台风数量。","parameters":[],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"不存在 / Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/history/{year}":{"get":{"operationId":"historyByYear","tags":["history"],"summary":"某年台风列表","description":"某年全部台风概要。","parameters":[{"name":"year","in":"path","required":true,"description":"年份","schema":{"type":"string"},"example":"2024"}],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"不存在 / Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/history/search/{keyword}":{"get":{"operationId":"historySearch","tags":["history"],"summary":"搜索台风","description":"按中文名/英文名/编号搜索, 最多 50 条。","parameters":[{"name":"keyword","in":"path","required":true,"description":"关键词","schema":{"type":"string"},"example":"山竹"}],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"不存在 / Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/history/today":{"get":{"operationId":"historyToday","tags":["history"],"summary":"历史上的今天","description":"历史上今天活跃过的知名台风。","parameters":[],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"不存在 / Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/global/typhoons":{"get":{"operationId":"listGlobal","tags":["global"],"summary":"全球活跃热带气旋","description":"西北太平洋以外: NHC/CPHC 与 JTWC 官方路径与预报。","parameters":[],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"不存在 / Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/global/typhoons/{id}":{"get":{"operationId":"getGlobal","tags":["global"],"summary":"单个全球气旋详情","description":"id 形如 ib-2005236n23285(IBTrACS 历史) / nhc-al052026 / jtwc-sh032026。","parameters":[{"name":"id","in":"path","required":true,"description":"气旋编号","schema":{"type":"string"},"example":"ib-2005236n23285"}],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"不存在 / Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/global/history":{"get":{"operationId":"globalHistory","tags":["global"],"summary":"全球气旋归档","description":"按年份或关键词查询全球气旋档案。","parameters":[{"name":"year","in":"query","required":false,"schema":{"type":"integer"},"example":2005},{"name":"q","in":"query","required":false,"schema":{"type":"string"},"example":"Katrina"}],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/seo/news":{"get":{"operationId":"flashNews","tags":["content"],"summary":"台风快讯","description":"最新台风快讯, 可用 code 过滤。","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/flash":{"get":{"operationId":"v1Flash","tags":["content"],"summary":"快讯分页列表","description":"APP 接口: 快讯分页。","parameters":[],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"不存在 / Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/news":{"get":{"operationId":"v1News","tags":["content"],"summary":"日报分页列表","description":"APP 接口: 每日台风日报分页。","parameters":[],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"不存在 / Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/knowledge":{"get":{"operationId":"v1Knowledge","tags":["content"],"summary":"台风百科列表","description":"APP 接口: 百科文章列表。","parameters":[],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"不存在 / Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/knowledge/{slug}":{"get":{"operationId":"v1KnowledgeArticle","tags":["content"],"summary":"百科文章详情","description":"含 Markdown 正文。","parameters":[{"name":"slug","in":"path","required":true,"description":"文章标识","schema":{"type":"string"},"example":"typhoon-levels"}],"responses":{"200":{"description":"成功 / OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"不存在 / Not found","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"x-markdown-pages":"任意 HTML 页面加 .md 后缀可得 Markdown 正文, 如 /typhoon/202411.md /index.md /en/knowledge.md","x-llms-txt":"https://taifengshuo.com/llms.txt"}