TyphoonSays Open API Documentation
TyphoonSays提供免费的公开只读 API, 可用 at 查询Live Typhoons与History数据. 所有Connected返回 JSON, 支持跨域(CORS). 请合理使用, 数据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 (1945 to now)
| 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 | Typhoon in history today |
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 / Client API (v1, Recommended)
面 toward 安卓/iOS/鸿蒙等客户端的稳定契约Connected, 统一返回信封结构 {"code":0,"msg":"ok","data":...,"ts":1710000000000}(code=0 成功, 非0 为业务错误码), 支持完整 CORS 预检(OPTIONS), 列表Connected统一分页参数 ?page=&size=(Size is up to 50).
| Connected | Explained |
|---|---|
GET /api/v1/bootstrap | APP 启动聚合Connected: 站点配置+公告+ActiveTyphoon 摘要+今日Briefing+版本信息(一次请求完成冷启动) |
GET /api/v1/version?platform=android|ios|harmony | Version checks / compulsory updates (latest/min/url/notes) |
GET /api/v1/typhoons / /api/v1/typhoons/{code} | ActiveTyphoon List / SingleTyphoon details (including Archive Return) |
GET /api/v1/flash / /api/v1/flash/{id} | Typhoon Flash News by page list / details |
GET /api/v1/news / /api/v1/news/{slug} | Typhoon News list by page / details (including source list) |
GET /api/v1/knowledge / /api/v1/knowledge/{slug} | Typhoon Wiki list / article details (including Markdown text) |
GET /api/v1/history/years / /api/v1/history/{year} / /api/v1/history/search/{kw} | The History Box(1945 to now) |
Error code agreed: 40001 Errors in parameters 40401 Resources do not exist 40400 Unknown Endpoint 50000 Service Error: All responses are carried. X-Api-Version: v1 The original website. /api/* Connected保持不变.
Data: Zhejiang Water Resources / CMA. For reference to this site data, please indicate the source "TyphoonSays taifengshuo.com".