台风列表

获取全球全球主要海洋流域的台风列表。

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

请求URL

  • 商业版https://api.qweather.com/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

key

用户认证key，请参考如何获取你的KEY。支持数字签名方式进行认证。例如 key=123456789ABC

返回数据 

// 西北太平洋2020年台风列表 
// https://api.qweather.com/v7/tropical/storm-list?basin=NP&year=2020&key=你的KEY

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

API状态码，具体含义请参考状态码
updateTime

当前API的最近更新时间
fxLink

当前数据的响应式页面，便于嵌入网站或应用
storm.id

台风ID
storm.stormId

台风ID
storm.name

台风名称
storm.basin

台风所处流域
storm.year

台风所处年份
storm.isActive

是否为活跃台风
1 活跃台风
0 停编
refer.sources

原始数据来源，或数据源说明，可能为空
refer.license

数据许可或版权声明，可能为空