天气预警城市列表

平台: API iOS Android

获取指定国家或地区当前正在发生天气灾害预警的城市列表，根据这些城市列表再查询对应城市的天气灾害预警。

注意：目前天气预警城市列表仅适用于获取中国（包括港澳台）城市列表。其他国家和地区，请使用天气灾害预警。

提示：关于更多天气预警数据的说明，请参考实用资料-预警信息。

请求URL

https://api.qweather.com/v7/warning/list?[请求参数]

如果是免费订阅，将上述API Host更改为devapi.qweather.com。参考免费订阅可用的数据。

请求参数

请求参数包括必选和可选参数，参数之间使用&进行分隔。

range(必选)选择指定的国家或地区，使用ISO 3166格式。例如range=cn或range=hk。目前该功能仅支持中国（包括港澳台）地区的城市列表，其他国家和地区请使用请使用[天气灾害预警]单独获取。
key(必选)用户认证key，请参考如何获取你的KEY。支持数字签名方式进行认证。例如 key=123456789ABC

请求示例

中国灾害预警城市列表

curl -L -X GET --compressed 'https://api.qweather.com/v7/warning/list?range=cn&key=YOUR_KEY'

返回数据

返回数据是JSON格式并进行了Gzip压缩，数据类型均为字符串。

{
  "code": "200",
  "updateTime": "2020-06-21T05:39+00:00",
  "warningLocList": [
    {
      "locationId": "101010800"
    },
    {
      "locationId": "101011200"
    },
    {
      "locationId": "101011400"
    },
    {
      "locationId": "101020700"
    },
    {
      "locationId": "101040400"
    },
    {
      "locationId": "101041900"
    },
    {
      "locationId": "101043400"
    },
    {
      "locationId": "101043600"
    },
    {
      "locationId": "101050106"
    },
    {
      "locationId": "101050107"
    },
    {
      "locationId": "101050301"
    },
    {
      "locationId": "101050302"
    },
    {
      "locationId": "101050303"
    },
    {
      "locationId": "101130103"
    },
    {
      "locationId": "101130109"
    },
    {
      "locationId": "101130114"
    },
    {
      "locationId": "101130302"
    },
    {
      "locationId": "101130303"
    },
    {
      "locationId": "101130409"
    },
    {
      "locationId": "101130610"
    },
    {
      "locationId": "101130611"
    },
    {
      "locationId": "101130613"
    },
    {
      "locationId": "101130614"
    },
    {
      "locationId": "101131920"
    },
    {
      "locationId": "101221008"
    },
    {
      "locationId": "101230507"
    },
    {
      "locationId": "101132101"
    },
    {
      "locationId": "101132201"
    },
    {
      "locationId": "101132301"
    }
  ],
  "refer": {
    "sources": [
      "12379",
      "QWeather"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

code 请参考状态码
updateTime 当前API的最近更新时间
warningLocList.locationId 当前国家预警的LocationID
refer.sources 原始数据来源，或数据源说明，可能为空
refer.license 数据许可或版权声明，可能为空