首页›开放API

台风说开放 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/bootstrapAPP 启动聚合接口: 站点配置+公告+活跃台风摘要+今日晨报+版本信息(一次请求完成冷启动)
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"。