台风说开放API文档 - 免费台风数据接口

LIVE

在线接口调试台 (API Explorer)

直接向当前节点发起真实 HTTP GET 请求并查看实时返回报文

GET

READY -- ms

// 点击上方「发送请求」或任一接口右侧的「在线调试 →」，即可在此处实时查看真实 JSON 响应。

00

接入规范、响应信封与错误码约定

Web 原生接口 (`/api/`) vs 客户端契约 (`/api/v1/`)

本站同时提供两套完全兼容的只读接口：/api/* 直接返回业务 JSON 对象，适合网页组件与脚本快速拉取；/api/v1/* 面向 iOS / Android / 鸿蒙 App 与生产级服务，统一包裹在 {"code":0,"msg":"ok","data":...,"ts":1761321600000} 标准信封中，并携带 X-Api-Version: v1 响应头。

缓存策略、并发限流与数据署名

所有公开接口均通过 Cloudflare 全球边缘节点缓存（Cache-Control: public, max-age=60~3600），支持全量 CORS 预检（OPTIONS）。建议客户端遵守边缘缓存周期，单 IP 轮询实时台风接口间隔不少于 30 秒。公开引用或二次开发请注明数据来源：台风说 (taifengshuo.com)。

code: 0请求成功 (HTTP 200)

code: 40001请求参数格式或范围错误

code: 40401台风编号或词条资源不存在

code: 50000上游气象源或服务端异常

01

实时台风与全球气旋

4 个端点

GET /api/typhoons

Edge Cache 60s · CORS *

获取西北太平洋实时活跃台风列表

返回当前西北太平洋及南海活跃台风的完整实况路径点、7/10/12级四象限风圈半径及中、美、日、港、台等多国官方机构预报路径；若当前无活跃台风，自动附带最近编号台风作为参考。

核心响应字段 (Response Schema)

字段路径	类型	字段说明
typhoons[].code	string	6位台风编号（如 "202609"）
typhoons[].name / enname	string	中文命名 / 国际英文名
typhoons[].active	boolean	是否处于活跃编报状态
typhoons[].points[]	array	实况路径序列（含 time, lat, lng, strong, power, speed, pressure, radius7/10/12）
typhoons[].forecasts	object	多国气象机构预报路径字典（中国/日本/美国/中国香港/中国台湾）

查看 JSON 响应示例展开 / 收起

{
  "typhoons": [
    {
      "code": "202411",
      "name": "摩羯",
      "enname": "YAGI",
      "active": false,
      "points": [
        {
          "time": "2024-09-06 16:00:00",
          "lat": 19.7,
          "lng": 110.8,
          "strong": "超强台风",
          "power": 17,
          "speed": 62,
          "pressure": 915,
          "moveDir": "西偏北",
          "moveSpeed": 20
        }
      ],
      "forecasts": { "中国": [...], "日本": [...], "美国": [...] }
    }
  ]
}

GET /api/typhoons/{code}

Edge Cache 120s · CORS *

查询单个台风完整路径与登陆详情

按 6 位年份编号查询单台风完整生命周期数据。内置三级自动回退机制：活跃缓存 → D1 1945–至今历史归档库 → 上游实时源。

请求参数 (Parameters)

参数名	位置 / 类型	说明与示例
code必填	path · string	6位台风编号（YYYYNN），如 202411（摩羯）、201822（山竹）（示例：`202411`）

核心响应字段 (Response Schema)

字段路径	类型	字段说明
typhoon.code	string	台风编号（如 "202411"）
typhoon.points[]	array	完整实况路径点数组（时间升序）
typhoon.land[]	array	登陆点记录（登陆时间、位置名称、经纬度、登陆强度）

查看 JSON 响应示例展开 / 收起

{
  "typhoon": {
    "code": "202411",
    "name": "摩羯",
    "enname": "YAGI",
    "startTime": "2024-09-01 20:00:00",
    "endTime": "2024-09-08 17:00:00",
    "land": [
      {
        "position": "海南省文昌市翁田镇沿海",
        "time": "2024-09-06 16:20:00",
        "strong": "超强台风",
        "power": 17,
        "speed": 62
      }
    ],
    "points": [ ... ]
  }
}

GET /api/global/typhoons

Edge Cache 300s · CORS *

全球海域活跃热带气旋列表 (NHC / JTWC)

实时聚合北大西洋、东北太平洋、北印度洋及南半球（南印度洋/南太平洋）活跃飓风与热带气旋，数据结构与 /api/typhoons 同构，每 15 分钟与 NOAA NHC / JTWC 同步。

核心响应字段 (Response Schema)

字段路径	类型	字段说明
cyclones[].id	string	全球唯一气旋标识（如 "nhc-al092026"、"jtwc-sh032026"）
cyclones[].basin	string	所属海域（AL=北大西洋, EP=东北太平洋, IO=北印度洋, SH=南半球）
cyclones[].windPeriod	string	风速取样时距标准（"1min" 或 "10min"）

查看 JSON 响应示例展开 / 收起

{
  "cyclones": [],
  "updatedAt": "2026-10-24T16:00:00.000Z",
  "sources": ["NOAA NHC/CPHC", "US JTWC"]
}

GET /api/global/history

Edge Cache 600s · CORS *

全球海域历史气旋归档检索

按年份或关键词检索全球非西北太平洋海域的历史飓风/气旋归档摘要（含巅峰等级、最大风速、最低气压与起止时间）。

请求参数 (Parameters)

参数名	位置 / 类型	说明与示例
year可选	query · number	按年份过滤，如 2026（示例：`2026`）
q可选	query · string	按英文名或 ATCF 编号模糊搜索（示例：`MILTON`）

查看 JSON 响应示例展开 / 收起

{
  "list": [
    {
      "id": "jtwc-sh182026",
      "atcf_id": "SH182026",
      "name": "MAILA",
      "basin": "SH",
      "year": 2026,
      "peak_strong": "超强台风",
      "max_speed": 60,
      "min_pressure": 926
    }
  ]
}

02

历史台风归档 (1945–)

4 个端点

GET /api/history/years

Edge Cache 3600s · CORS *

1945–至今历年台风统计总览

返回 1945 年以来每个年份的归档台风总数，适用于构建年份选择器或年度气候趋势折线图。

查看 JSON 响应示例展开 / 收起

{
  "years": [
    { "year": 2026, "count": 30 },
    { "year": 2025, "count": 26 },
    { "year": 2024, "count": 26 },
    { "year": 1945, "count": 26 }
  ]
}

GET /api/history/{year}

Edge Cache 3600s · CORS *

查询指定年份全部台风列表

返回指定年份（1945–2026）生成的所有西北太平洋台风概要信息，包含巅峰强度、最大风速、最低中心气压与起止时间。

请求参数 (Parameters)

参数名	位置 / 类型	说明与示例
year必填	path · number	4位年份（1945–2026）（示例：`2024`）

查看 JSON 响应示例展开 / 收起

{
  "year": 2024,
  "typhoons": [
    {
      "code": "202411",
      "name": "摩羯",
      "enname": "YAGI",
      "strong": "超强台风",
      "max_speed": 68,
      "min_pressure": 905,
      "start_time": "2024-09-01 14:00:00",
      "end_time": "2024-09-08 17:00:00"
    }
  ]
}

GET /api/history/search/{keyword}

Edge Cache 600s · CORS *

按中文名 / 英文名 / 编号搜索历史台风

支持按中文名（如“山竹”“威马逊”）、国际英文名（如“MANGKHUT”“HAIYAN”）或编号前缀快速检索历史台风（单次最多返回 50 条）。

请求参数 (Parameters)

参数名	位置 / 类型	说明与示例
keyword必填	path · string	台风中英文名称或编号片段（示例：`山竹`）

查看 JSON 响应示例展开 / 收起

{
  "results": [
    {
      "code": "201822",
      "year": 2018,
      "name": "山竹",
      "enname": "MANGKHUT",
      "strong": "超强台风",
      "max_speed": 65,
      "min_pressure": 910
    }
  ]
}

GET /api/history/today

Edge Cache 3600s · CORS *

历史上的今天活跃知名台风

查询 1945 年以来在当年今日（MM-DD）处于活跃状态的知名历史台风列表。

查看 JSON 响应示例展开 / 收起

{
  "date": "10-24",
  "typhoons": [ ... ]
}

03

客户端稳定契约 (API v1)

3 个端点

GET /api/v1/bootstrap

Public 60s · X-Api-Version: v1

客户端冷启动聚合包 (Bootstrap)

面向 iOS / Android / HarmonyOS 及第三方小程序的首屏冷启动聚合接口：1 次请求返回站点配置、置顶公告、当前活跃台风摘要、今日 AI 晨报及各端最新版本信息。统一包裹于 { code: 0, msg: "ok", data, ts } 标准信封。

核心响应字段 (Response Schema)

字段路径	类型	字段说明
code	number	状态码：0 表示成功，非 0 为业务错误码
data.activeTyphoons[]	array	当前活跃台风轻量摘要（含最新经纬度、风速、气压、等级）
data.briefing	string	台风君今日气象晨报文本
data.version	object	Android / iOS / HarmonyOS 最新版本号与下载地址

查看 JSON 响应示例展开 / 收起

{
  "code": 0,
  "msg": "ok",
  "data": {
    "activeTyphoons": [],
    "briefing": "今日西北太平洋洋面整体平静...",
    "version": {
      "api": "v1",
      "android": { "latest": "1.2.0", "min": "1.0.0" },
      "ios": { "latest": "1.2.0", "min": "1.0.0" }
    }
  },
  "ts": 1761321600000
}

GET /api/v1/flash

Edge Cache 60s · X-Api-Version: v1

7×24 台风快讯分页列表 (v1)

分页获取已发布的实时台风快讯流（含 AI 台风君专业点评、结构化实况快照与发布时间），支持下拉刷新与无限滚动。

请求参数 (Parameters)

参数名	位置 / 类型	说明与示例
page可选	query · number	页码（从 1 开始，默认 1）（示例：`1`）
size可选	query · number	每页条数（1–50，默认 20）（示例：`5`）

查看 JSON 响应示例展开 / 收起

{
  "code": 0,
  "msg": "ok",
  "data": {
    "page": 1,
    "size": 5,
    "total": 420,
    "list": [
      {
        "id": 812,
        "title": "台风外围环流影响华南沿海...",
        "ai_comment": "台风君点评：...",
        "flash_at": "2026-10-24 14:30:00"
      }
    ]
  },
  "ts": 1761321600000
}

GET /api/v1/knowledge

Edge Cache 600s · X-Api-Version: v1

台风百科词条全量目录与详情 (v1)

获取台风说 80 篇专业防灾与气象百科词条列表；传入 /api/v1/knowledge/{slug} 可直接拉取单篇词条的完整 Markdown 正文与 SEO 摘要。

查看 JSON 响应示例展开 / 收起

{
  "code": 0,
  "msg": "ok",
  "data": {
    "list": [
      {
        "slug": "hk-typhoon-signals-explained",
        "title": "香港8号风球、10号风球是什么意思？与内地蓝黄橙红预警对照表",
        "summary": "香港天文台风球信号（1号、3号、8号、9号、10号）代表什么风力..."
      }
    ]
  },
  "ts": 1761321600000
}

04

AI 摘要与快讯百科

2 个端点

GET /api/llm/summary

Edge Cache 120s · CORS *

AI 大模型 / Agent 专用实时台风态势摘要

专为大语言模型（LLM Function Calling / MCP 插件 / 智能体）设计的零冗余实时态势接口，同时返回自然语言态势简报（summary）与精简结构化数据（typhoons + global）。

查看 JSON 响应示例展开 / 收起

{
  "updatedAt": "2026-10-24T16:00:00.000Z",
  "summary": "截至当前，西北太平洋及南海无编号活跃台风...",
  "typhoons": [],
  "global": []
}

GET /api/seo/news

Edge Cache 300s · CORS *

台风实时监测动态播报流

返回基于实时气象报文自动生成的台风位置、风速、气压与多机构预报综述，可通过 ?code=YYYYNN 过滤指定台风。

请求参数 (Parameters)

参数名	位置 / 类型	说明与示例
code可选	query · string	可选，按6位台风编号过滤（示例：`202411`）

查看 JSON 响应示例展开 / 收起

{
  "items": [
    {
      "code": "202411",
      "name": "摩羯",
      "title": "超强台风摩羯（202411）最新位置与路径分析",
      "summary": "中心最大风速62m/s，中心最低气压915hPa..."
    }
  ]
}

追台风

查资料

玩社区

关于

台风说开放数据平台 & API 参考手册

在线接口调试台 (API Explorer)

接入规范、响应信封与错误码约定

Web 原生接口 (`/api/`) vs 客户端契约 (`/api/v1/`)

缓存策略、并发限流与数据署名

实时台风与全球气旋

获取西北太平洋实时活跃台风列表

查询单个台风完整路径与登陆详情

全球海域活跃热带气旋列表 (NHC / JTWC)

全球海域历史气旋归档检索

历史台风归档 (1945–)

1945–至今历年台风统计总览

查询指定年份全部台风列表

按中文名 / 英文名 / 编号搜索历史台风

历史上的今天活跃知名台风

客户端稳定契约 (API v1)

客户端冷启动聚合包 (Bootstrap)

7×24 台风快讯分页列表 (v1)

台风百科词条全量目录与详情 (v1)

AI 摘要与快讯百科

AI 大模型 / Agent 专用实时台风态势摘要

台风实时监测动态播报流

Web 原生接口 (/api/*) vs 客户端契约 (/api/v1/*)

缓存策略、并发限流与数据署名

获取西北太平洋实时活跃台风列表

查询单个台风完整路径与登陆详情

全球海域活跃热带气旋列表 (NHC / JTWC)

全球海域历史气旋归档检索

1945–至今历年台风统计总览

查询指定年份全部台风列表

按中文名 / 英文名 / 编号搜索历史台风

历史上的今天活跃知名台风

客户端冷启动聚合包 (Bootstrap)

7×24 台风快讯分页列表 (v1)

台风百科词条全量目录与详情 (v1)

AI 大模型 / Agent 专用实时台风态势摘要

台风实时监测动态播报流

Web 原生接口 (`/api/`) vs 客户端契约 (`/api/v1/`)