数据查询专用接口 - 全国气象预警历史存档

功能介绍

数据查询专用接口是本站为具有特定需求访客专门开发的API产品。

若查询格式正确，服务端将以JSON的格式返回查询结果。

使用此产品均需要申请访问代码，申请方式详见预警详情、年份索引等需要访问代码的页面。

目录：查询特定条件的预警列表 通用错误码

查询特定条件的预警列表

此API用于查询特定发布单位、省份、时间范围、预警类型、等级、ID的预警列表（不含预警正文）。

单次查询最大发布单位数为500，最大预警信息数为10000，超出将直接返回负数状态码以及错误信息。

为保证查询速度，查询结果不会自动排序。查询结果将在本地缓存1分钟。

URL：https://www.natyphoon.top/WeatherAlert/Info/q1?<参数>

参数：

• a：发布单位。名称需和“历史查询”页中的发布单位名称相同。使用半角逗号以同时指定多个发布单位。留空代表全部。
• p：省份。使用半角逗号以同时指定多个省份。留空代表全部。
• b：起始时间。使用YYYYMMDDHHMMSS或其他支持的时间格式。必填。
• e：终止时间。使用YYYYMMDDHHMMSS或其他支持的时间格式。留空代表与起始时间相同；若留空时起始时间只填写到日期，则代表查询当天的所有预警。不允许跨年查询。
• t：预警类型。使用半角逗号以同时指定多个预警类型。留空代表全部。
• l：预警等级。使用下列数字相加以实现一个或多个等级查询，1白色，2蓝色，4黄色，8橙色，16红色，32（不适用）其他。留空代表全部（即63）。
• i：预警ID。查询开头与此参数相同的预警ID。使用半角逗号以同时指定多个预警ID。留空代表全部。
• _：回传数字。服务端将在返回数据中显示相同数字。留空代表0。

示例1：

参数：a=中央气象台&b=20250102

含义：查询中央气象台2025年1月2日当天的所有预警信息。返回结果如下所示。

示例2：

参数：a=北京市&b=20250101&e=20251231235959

含义：查询发布单位为“北京市”的2025年所有气象预警，不含北京下辖各区。

示例3：

参数：p=北京,天津&b=20250516

含义：查询2025年5月16日当天北京、天津及下辖各区的所有气象预警。

示例4：

参数：p=北京&b=20250101&e=20251231235959&t=冰雹,雷电

含义：查询2025年北京及下辖各区的所有冰雹和雷电预警。

示例5：

参数：a=河北省&b=20250101&e=20251231235959&t=大风&l=24

含义：查询2025年河北省气象台的所有大风橙色和红色预警。

示例6：

参数：b=20250601&i=X,Y&_=100

含义：查询2025年6月1日当天所有人工加入的预警，并返回一个数字100。

示例7：

参数：b=20250101&e=20251231235959

含义：尝试查询2025年所有气象预警，将因为数量过多而终止查询并返回错误信息。返回结果如下所示。

通用错误码

查询失败时，服务器将会返回一个code错误码用以揭示失败原因。含义与HTTP 响应状态码基本一致。

• 负数：查询时出现异常。
• 400：参数格式错误。
• 401：访问代码未通过。
• 500：服务器内部错误。

返回示例：