台风列表

台风列表API提供全球主要海洋流域最近2年的台风列表。

目前仅支持中国沿海地区，即basin=NP

请求路径#

GET /v7/tropical/storm-list

参数#

查询参数

basin (必选)
需要查询的台风所在的流域，例如中国处于西北太平洋，即 basin=NP。当前仅支持NP。
- AL North Atlantic 北大西洋
- EP Eastern Pacific 东太平洋
- NP NorthWest Pacific 西北太平洋
- SP SouthWestern Pacific 西南太平洋
- NI North Indian 北印度洋
- SI South Indian 南印度洋
year (必选) 支持查询本年度和上一年度的台风，例如：year=2020, year=2019

请求示例#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/v7/tropical/storm-list?basin=NP&year=2023'

请将your_token替换为你的JWT身份认证，将your_api_host替换为你的API Host

试一下

返回数据#

{
  "code": "200",
  "updateTime": "2020-12-31T16:00+00:00",
  "fxLink": "https://www.qweather.com",
  "storm": [
    {
      "id": "NP_2022",
      "name": "环高",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2021",
      "name": "艾涛",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2020",
      "name": "艾莎尼",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2019",
      "name": "天鹅",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2018",
      "name": "莫拉菲",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2017",
      "name": "沙德尔",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_200012",
      "name": "无命名",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2016",
      "name": "浪卡",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2015",
      "name": "莲花",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2014",
      "name": "灿鸿",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2013",
      "name": "鲸鱼",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2012",
      "name": "白海豚",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2011",
      "name": "红霞",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2010",
      "name": "海神",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2009",
      "name": "美莎克",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2008",
      "name": "巴威",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2007",
      "name": "海高斯",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2006",
      "name": "米克拉",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2005",
      "name": "蔷薇",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2004",
      "name": "黑格比",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2003",
      "name": "森拉克",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2002",
      "name": "鹦鹉",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    },
    {
      "id": "NP_2001",
      "name": "黄蜂",
      "basin": "NP",
      "year": "2020",
      "isActive": "0"
    }
  ],
  "refer": {
    "sources": [
      "https://developer.qweather.com/attribution.html"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

code string 状态码
updateTime date-time API的最近更新时间
fxLink uri 当前数据的响应式页面，便于嵌入网站或应用
storm object 台风列表
- id string 台风ID
- name string 台风名称
- basin string 台风所处流域
- year string 台风所处年份
- isActive string 是否为活跃台风。1 活跃台风，0 停编
refer object 数据来源和许可信息
- sources array 原始数据来源，或数据源说明，可能为空
- license array 数据许可或版权声明，可能为空