天气预警与天气预报不同，它一般情况下不会出现提示，但是只要出现了异常天气，如降温降雪等天气时就会弹出提醒。气象预警API接口的主要功能是通过调用该接口，查询全国各地甚至其他国家气象台站的气象灾害类型、等级和时间预报。它的数据来自国家气象中心，收集各个气象站观测到的数据。

天气预警信号分为十一级：台风、暴雨、高温、寒潮、大雾、雷雨大风、大风、沙尘暴、冰雹、雪灾和道路积冰。其预警信号总体上可以分为四级(一至四级)，并且按照灾害的严重和紧急程度，可以依次分为蓝色、黄色、橙色和红色(一般、较重、严重和特别严重)。现在很多地方的极端天气变得越来越频繁，因此天气预警也越来越重要。

天气预警API对于人民的作用：及时预警有助于城市防灾减灾，气象台发布预警信号后，可以通过气象预警API接口查询相关信息，根据防御指南做出相应防御。比如，根据暴雨红色预警信号，有关部门要做好暴雨应急和抢险工作;提高居民防范气象灾害的意识，为人们出行提供指导。如果发现暴雪预警信号，行人注意防寒防滑，司机对车辆采取防滑措施。

天气预警API对于农业相关企业的作用：及时提供预警信息，帮助农业生产，减少灾害造成的损失:应对暴雨预警，农田可以做好排水排涝;应对暴雪预警，农民可以提前做好牲畜保暖，对不耐寒的作物采取一定措施;应对寒潮预警，对牲畜和农作物采取防风防寒措施，减少损失。

APISpace 的 天气预警API，获取指定城市当前生效中的各类天气预警，如寒潮蓝色预警信号，或一次性拉取全国所有生效中的天气预警。除了台风、暴雨、暴雪、大风、高温、雷电、大雾、寒潮等最基本的16种天气预警类型之外，还可查询额外30种预警类型，包括空气重污染、干热风、海上大风、高温中暑、洪涝灾害、地质灾害、山洪灾害、城市内涝、洪水灾害、持续低温等。

接口请求Query参数：

areacode：城市ID(不传则返回所有生效预警)

接口返回示例：

{
    "status": 0,
    "result": {                    //传areacode的返回示例
        "location": {
            "areacode": "101250101",        //城市ID
            "name": "长沙",                        //城市中文名
            "country": "中国",                //所属国家中文名
            "path": "长沙,长沙市,湖南省,中国"            //行政区划路径
        },
        "alerts": [
            {
                "geocode": "430000",                //预警地区编码
                "title": "湖南省森林防灭火指挥部发布森林火险黄色预警[Ⅲ级/较重]",                //预警标题
                "desc": "湖南省森林防灭火指挥部2月27日发布森林火险黄色预警：未来……",//预警详情
                "type": "森林火险",                        //预警类型
                "level": "黄色预警",                        //预警等级
                "public_time": "2020-02-27 09:50:44",        //预警发布时间
                "effective": "2020-02-27 09:50:44",        //预警生效时间
                "expires": "2020-02-28 00:00:00"                //预警失效时间
            }
                ……                                    //其它当地预警信息
        ]
    }
}