TyphoonSays Open API Documentation
TyphoonSays provides free public only reading API, available at query Live Typhoons and History data. All interfaces return JSON, Cross-domain support (CORS). Please reasonably use, data For reference only; official releases prevail.
Live data
| Connected | Explained |
|---|---|
GET /api/typhoons | Active Typhoons list (complete track points/wind circle/multi-organized forecast) |
GET /api/typhoons/{code} | Typhoon details, such as /api/typhoons/202609(Active → Archive → Upstream Live Level 3 Return) |
Historical data (since 1945)
| Connected | Explained |
|---|---|
GET /api/history/years | Archive for Year Statistics |
GET /api/history/{year} | List of all typhoons of a year |
GET /api/history/search/{keyword} | By name/codeSearchTyphoon (up to 50 items) |
GET /api/history/today | History of Today知名Typhoon |
GET /api/seo/news | Latest Typehoon Flash News (AI formed, can add ?code= filter) |
Examples of data structures
GET /api/typhoons/202609 Return to:
| The field | Explained |
|---|---|
typhoon.code | Typhoon code, such as 202609 |
typhoon.name / enname | Chinese and English names |
typhoon.points[] | Track points range: time/lat/lng/strong/power/speed/pressure/moveDir/radius7/radius10/radius12 |
typhoon.forecasts | Multi-organized Forecast path: China/Japan/USA/Hong Kong, China/Taiwan, China etc. |
typhoon.land[] | Landfall information |
APP / 客户端 API (v1, 推荐)
面 toward 安卓/iOS/鸿蒙等客户端的稳定契约Connected, 统一返回信封结构 {"code":0,"msg":"ok","data":...,"ts":1710000000000}(code=0 成功, 非0 为业务错误码), 支持完整 CORS 预检(OPTIONS), 列表Connected统一分页参数 ?page=&size=(size 上限 50).
| Connected | Explained |
|---|---|
GET /api/v1/bootstrap | APP 启动聚合Connected: 站点配置+公告+ActiveTyphoon 摘要+今日Briefing+版本信息(一次请求完成冷启动) |
GET /api/v1/version?platform=android|ios|harmony | 版本检查/强制更新(latest/min/url/notes) |
GET /api/v1/typhoons / /api/v1/typhoons/{code} | ActiveTyphoon 列表 / 单Typhoon details(含Archive回退) |
GET /api/v1/flash / /api/v1/flash/{id} | Typhoon Flash News分页列表 / details |
GET /api/v1/news / /api/v1/news/{slug} | Typhoon News日报分页列表 / details(含来源列表) |
GET /api/v1/knowledge / /api/v1/knowledge/{slug} | Typhoon Wiki列表 / 文章details(含 Markdown 正文) |
GET /api/v1/history/years / /api/v1/history/{year} / /api/v1/history/search/{kw} | The History Box(since 1945) |
错误码约定: 40001 参数错误 · 40401 资源不存在 · 40400 unknown端点 · 50000 服务端错误. 所有响应携带 X-Api-Version: v1 头. 网页端原有 /api/* Connected保持不变.
Data: Zhejiang Water Resources / CMA. 如引用本站数据, 请注明来源"TyphoonSays taifengshuo.com".